IDebugControl2 ::GetExtensionFunction, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetExtensionFunction retourne un pointeur vers une fonction d’extension à partir d’une bibliothèque d’extensions.

Syntaxe

HRESULT GetExtensionFunction(
  [in]  ULONG64 Handle,
  [in]  PCSTR   FuncName,
  [out] FARPROC *Function
);

Paramètres

[in] Handle

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

[in] FuncName

Spécifie le nom de la fonction d’extension à retourner. Lorsque vous recherchez les bibliothèques d’extensions pour la fonction, le moteur du débogueur est ajouté à «EFN» au nom. Par exemple, si funcName est « SampleFunction », le moteur recherche les bibliothèques d’extensions pour « _EFN_SampleFunction ».

[out] Function

Reçoit la fonction d’extension.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

Les bibliothèques d’extensions sont chargées dans le moteur hôte et les fonctions d’extension ne peuvent pas être appelées à distance. Le client actuel ne doit pas être un client de débogage, il doit appartenir au moteur hôte.

La fonction d’extension peut avoir n’importe quel prototype de fonction. Pour que tout programme appelle cette fonction d’extension, la fonction d’extension doit être convertie en prototype correct.

Pour plus d’informations sur l’utilisation de fonctions d’extension, consultez Appels d’extensions et fonctions d’extension.