Partager via


IDebugHost ::GetHostDefinedInterface, méthode (dbgmodel.h)

La méthode GetHostDefinedInterface retourne l’interface privée principale de l’hôte, le cas échéant pour l’hôte donné. Pour les outils de débogage pour Windows, l’interface retournée ici est un IDebugClient (cast vers IUnknown).

Syntaxe

HRESULT GetHostDefinedInterface(
  IUnknown **hostUnk
);

Paramètres

hostUnk

L’interface privée principale de l’hôte de débogage est retournée ici. Pour les outils de débogage pour Windows, il s’agit d’une interface IDebugClient.

Valeur de retour

Cette méthode retourne HRESULT qui indique la réussite ou l’échec. Un hôte qui n’a pas d’interface privée qu’il souhaite exposer aux clients de modèle de données peut retourner E_NOTIMPL ici.

Remarques

Exemple de code

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!
    }
}

Exigences

Exigence Valeur
d’en-tête dbgmodel.h

Voir aussi

interface IDebugHost