PDEBUG_EXTENSION_QUERY_VALUE_NAMES Rückruffunktion (dbgeng.h)

Artikel
02/26/2024

Die Rückruffunktion DebugExtensionQueryValueNames stellt Pseudoregisterwerte wieder her.

 CALLBACK* PDEBUG_EXTENSION_QUERY_VALUE_NAMES DebugExtensionQueryValueNames;

Syntax

PDEBUG_EXTENSION_QUERY_VALUE_NAMES PdebugExtensionQueryValueNames;

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

Parameter

[in] Client

Ein Client, der verwendet werden soll, wenn die Erweiterung DbgEng-Funktionen benötigt.

[in] Flags

Stellt Verhaltensflags bereit. Dieser Parameter ist derzeit reserviert.

[out] Buffer

Ein Zeichenfolgenpuffer, den der Aufrufer bereitstellt, der mit dem Satz von Wertnamen gefüllt werden soll, den der Client verfügbar machen möchte.

[in] BufferChars

Die Anzahl der Breitzeichen in Buffer.

[out] BufferNeeded

Die Anzahl der Breitzeichen, die diese Funktion erfolgreich abschließen muss.

Rückgabewert

DebugExtensionQueryValueNames gibt möglicherweise einen der folgenden Werte zurück:

Rückgabecode	BESCHREIBUNG
S_OK	Die Funktion wurde erfolgreich abgeschlossen.
S_FALSE	Die Funktion wurde ohne Fehler abgeschlossen, aber sie hat nur Teilergebnisse erhalten.

Diese Funktion kann auch Fehlerwerte zurückgeben. Weitere Informationen zu möglichen Rückgabewerten finden Sie unter Rückgabewerte.

Hinweise

Wertnamen müssen mit $$ beginnen und ein endendes NULL-Zeichen aufweisen. Die Pufferzeichenfolge muss ebenfalls NULL-endend sein. Beispielsweise könnte Puffer "$$myval 1\0$$myval 2\0\0" sein.

DebugExtensionQueryValueNames wird PDEBUG_EXTENSION_QUERY_VALUE_NAMES in der Headerdatei Dbgeng.h aufgerufen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h

Weitere Informationen

DebugExtensionInitialize

DebugExtensionNotify

DebugExtensionProvideValue

DebugExtensionUninitialize

KnownStructOutput

Freigeben über