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

Article
02/06/2025

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 guide 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 passés à celui-ci lorsqu’elle est appelée en tant que commande d’extension.

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 Handle est égal à zéro, le moteur recherche chaque bibliothèque d’extensions jusqu’à ce qu’elle 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 Appels d’extensions et fonctions d’extension.