IDebugControl ::GetWindbgExtensionApis32, méthode (dbgeng.h)

Article
02/06/2025

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 nSize membre de cette structure doit être défini sur la taille de la structure avant de passer à cette méthode.

Valeur de retour

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

Retourner le code	Description
S_OK	La méthode a réussi.
E_INVALIDARG	La valeur de Api->nSize 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 vraiment 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.