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

Article
02/06/2025

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 complet et le nom de fichier de la bibliothèque d’extensions à charger.

[in] Flags

Défini sur zéro.

[out] Handle

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

Valeur de retour

Retourner le code	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 vers 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 Chemin d’accès 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 pour une utilisation, effectuez un appel ultérieur au GetExtensionFunction.

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