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

Article
02/23/2024

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 parcourra 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. Lors de la recherche de la fonction dans les bibliothèques d’extensions, le moteur du débogueur ajoute « EFN » au nom. Par exemple, si FuncName est « SampleFunction », le moteur recherche « _EFN_SampleFunction » dans les bibliothèques d’extensions.

[out] Function

Reçoit la fonction d’extension.

Valeur retournée

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

Code de retour	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 qu’un programme appelle cette fonction d’extension, la fonction d’extension doit être castée vers le prototype approprié.

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