IDebugHost::GetHostDefinedInterface-Methode (dbgmodel.h)
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 |