IDebugHost::GetHostDefinedInterface-Methode (dbgmodel.h)

Die GetHostDefinedInterface-Methode gibt die private Hauptschnittstelle des Hosts zurück, sofern dies für den angegebenen Host vorhanden ist. Für Debuggingtools für Windows ist die hier zurückgegebene Schnittstelle ein IDebugClient (cast to IUnknown).

Syntax

HRESULT GetHostDefinedInterface(
  IUnknown **hostUnk
);

Parameter

hostUnk

Die zentrale private Schnittstelle des Debughosts wird hier zurückgegeben. Für Debuggingtools für Windows ist dies eine IDebugClient-Schnittstelle.

Rückgabewert

Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt. Ein Host, der keine private Schnittstelle aufweist, die er für Datenmodellclients verfügbar machen möchte, gibt hier möglicherweise E_NOTIMPL zurück.

Bemerkungen

Codebeispiel

ComPtr<IDebugHost> spHost; /* get the debug host */

// Get the debug host private interface back from the host interfaces.  
// This is **HOST SPECIFIC**
ComPtr<IUnknown> spPrivate;
if (SUCCEEDED(spHost->GetHostDefinedInterface(&spPrivate)))
{
    // As an example, consider DbgEng:
    ComPtr<IDebugClient> spClient;
    if (SUCCEEDED(spPrivate.As(&spClient)))
    {
        // spClient now contains a DbgEng IDebugClient!
    }
}

Anforderungen

Siehe auch

IDebugHost-Schnittstelle