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
| Anforderung | Wert |
|---|---|
| Header- | dbgmodel.h |