Méthode IDebugControl3 ::CallExtension (dbgeng.h)

Article
02/26/2024

La méthode CallExtension appelle une extension de débogueur.

Syntaxe

HRESULT CallExtension(
  [in]           ULONG64 Handle,
  [in]           PCSTR   Function,
  [in, optional] PCSTR   Arguments
);

Paramètres

[in] Handle

Spécifie le handle de la bibliothèque d’extensions qui contient l’extension à appeler. Si Handle est égal à zéro, le moteur parcourra la chaîne de bibliothèque d’extensions à la recherche de l’extension.

[in] Function

Spécifie le nom de l’extension à appeler.

[in, optional] Arguments

Spécifie les arguments à passer à l’extension. Arguments est une chaîne qui sera analysée par l’extension, tout comme l’extension analysera les arguments qui lui sont passés lorsqu’elle est appelée en tant que commande d’extension.

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 Handle est égal à zéro, le moteur recherche chaque bibliothèque d’extensions jusqu’à ce qu’il en trouve une qui contient l’extension ; l’extension est ensuite appelée. Si l’extension retourne DEBUG_EXTENSION_CONTINUE_SEARCH, la recherche se poursuit.

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