IDebugHost::GetHostDefinedInterface-Methode (dbgmodel.h)

  • Artikel

Die GetHostDefinedInterface-Methode gibt die Standard privaten Schnittstelle des Hosts zurück, sofern eine solche für den angegebenen Host vorhanden ist. Für Debugtools für Windows ist die hier zurückgegebene Schnittstelle ein IDebugClient (in IUnknown umgewandelt).

Syntax

HRESULT GetHostDefinedInterface(
  IUnknown **hostUnk
);

Parameter

hostUnk

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

Rückgabewert

Diese Methode gibt HRESULT zurück, das auf Erfolg oder Fehler hinweist. 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.

Hinweise

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

Anforderung Wert
Header dbgmodel.h

Weitere Informationen

IDebugHost-Schnittstelle