Méthode IDebugControl4 ::GetExtensionFunctionWide (dbgeng.h)

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

Syntaxe

HRESULT GetExtensionFunctionWide(
  [in]  ULONG64 Handle,
  [in]  PCWSTR  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 va parcourir 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 .

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 dans le prototype approprié.

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

Configuration requise

Voir aussi

AddExtension

CallExtension

GetExtensionByPath

IDebugControl4