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

Article
02/26/2024

La méthode AddExtension charge une bibliothèque d’extensions dans le moteur de débogueur.

Syntaxe

HRESULT AddExtension(
  [in]  PCSTR    Path,
  [in]  ULONG    Flags,
  [out] PULONG64 Handle
);

Paramètres

[in] Path

Spécifie le chemin d’accès complet et le nom de fichier de la bibliothèque d’extensions à charger.

[in] Flags

Définit la valeur zéro.

[out] Handle

Reçoit le handle de la bibliothèque d’extensions chargée.

Valeur retournée

Code de retour	Description
S_OK	La méthode a réussi.

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

Remarques

Si la bibliothèque d’extensions a déjà été chargée, le handle de la bibliothèque déjà chargée est retourné. La bibliothèque d’extensions n’est plus chargée.

La bibliothèque d’extensions est chargée dans le moteur hôte et Path contient un chemin d’accès et un nom de fichier pour cette instance du moteur de débogueur.

AddExtension ne termine pas le processus de chargement et d’initialisation de la DLL d’extension. Pour rendre l’extension disponible, effectuez un appel suivant à getExtensionFunction.

Pour plus d’informations sur l’utilisation des bibliothèques d’extensions, consultez Appel d’extensions et fonctions d’extension.