Partager via


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

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.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)

Voir aussi

GetExtensionFunction

GetExtensionByPath

RemoveExtension

IDebugControl

IDebugControl2

IDebugControl3