Méthode IDebugControl ::GetWindbgExtensionApis32 (dbgeng.h)

Article
02/23/2024

La méthode GetWindbgExtensionApis32 retourne une structure qui facilite l’utilisation de l’API WdbgExts.

Syntaxe

HRESULT GetWindbgExtensionApis32(
  [in, out] PWINDBG_EXTENSION_APIS32 Api
);

Paramètres

[in, out] Api

Reçoit une structure WINDBG_EXTENSION_APIS32. Cette structure contient les fonctions utilisées par l’API WdbgExts. Le membre nSize de cette structure doit être défini sur la taille de la structure avant d’être passé à cette méthode.

Valeur retournée

Cette méthode peut également retourner d’autres valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour	Description
S_OK	La méthode a réussi.
E_INVALIDARG	La valeur d’Api->nSize n’est pas égale à la taille de la structure WINDBG_EXTENSION_APIS32.

Remarques

Si vous incluez Wdbgexts.h dans votre code d’extension, vous devez appeler cette méthode lors de l’initialisation de la DLL d’extension (voir DebugExtensionInitialize).

De nombreuses fonctions WdbgExts sont en fait des macros. Pour vous assurer que ces macros fonctionnent correctement, la structure reçue par le paramètre Api doit être stockée dans une variable globale nommée ExtensionApis.

Pour obtenir la liste des fonctions fournies par l’API WdbgExts, consultez Fonctions WdbgExts.