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

Article
02/23/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 va parcourir 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 a la valeur zéro, le moteur recherche chaque bibliothèque d’extensions jusqu’à ce qu’il en trouve une qui contient l’extension ; l’extension sera ensuite appelée. Si l’extension retourne DEBUG_EXTENSION_CONTINUE_SEARCH, la recherche continue.

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