PDEBUG_EXTENSION_QUERY_VALUE_NAMES fonction de rappel (dbgeng.h)

Article
02/23/2024

La fonction de rappel DebugExtensionQueryValueNames récupère les valeurs de pseudo-registre .

 CALLBACK* PDEBUG_EXTENSION_QUERY_VALUE_NAMES DebugExtensionQueryValueNames;

Syntaxe

PDEBUG_EXTENSION_QUERY_VALUE_NAMES PdebugExtensionQueryValueNames;

HRESULT PdebugExtensionQueryValueNames(
  [in]  PDEBUG_CLIENT Client,
  [in]  ULONG Flags,
  [out] PWSTR Buffer,
  [in]  ULONG BufferChars,
  [out] PULONG BufferNeeded
)
{...}

Paramètres

[in] Client

Client à utiliser si l’extension a besoin de fonctions DbgEng.

[in] Flags

Fournit des indicateurs comportementaux. Ce paramètre est actuellement réservé.

[out] Buffer

Mémoire tampon de chaîne que l’appelant fournit, à remplir avec l’ensemble de noms de valeurs que le client souhaite exposer.

[in] BufferChars

Nombre de caractères larges dans Buffer.

[out] BufferNeeded

Nombre de caractères larges dont cette fonction a besoin pour s’exécuter correctement.

Valeur retournée

DebugExtensionQueryValueNames peut retourner l’une des valeurs suivantes :

Code de retour	Description
S_OK	La fonction s’est terminée avec succès.
S_FALSE	La fonction s’est terminée sans erreur, mais elle n’a obtenu que des résultats partiels.

Cette fonction peut également retourner des valeurs d’erreur. Pour plus d’informations sur les valeurs de retour possibles, consultez Valeurs de retour.

Remarques

Les noms de valeurs doivent commencer par $$ et avoir un caractère NULL de fin. La chaîne de mémoire tampon doit également être terminée par null. Par exemple, Buffer peut être « $$myval 1\0$$myval 2\0\0 ».

DebugExtensionQueryValueNames est appelé PDEBUG_EXTENSION_QUERY_VALUE_NAMES dans le fichier d’en-tête Dbgeng.h.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h

Voir aussi

DebugExtensionInitialize

DebugExtensionNotify

DebugExtensionProvideValue

DebugExtensionUninitialize

KnownStructOutput

Partager via