funzione di callback PDEBUG_EXTENSION_QUERY_VALUE_NAMES (dbgeng.h)

Articolo
02/23/2024

La funzione di callback DebugExtensionQueryValueNames recupera i valori pseudoregistrazione .

 CALLBACK* PDEBUG_EXTENSION_QUERY_VALUE_NAMES DebugExtensionQueryValueNames;

Sintassi

PDEBUG_EXTENSION_QUERY_VALUE_NAMES PdebugExtensionQueryValueNames;

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

Parametri

[in] Client

Un client da usare se l'estensione richiede funzioni DbgEng.

[in] Flags

Fornisce flag comportamentali. Questo parametro è attualmente riservato.

[out] Buffer

Buffer stringa fornito dal chiamante, che deve essere compilato con il set di nomi di valore che il client vuole esporre.

[in] BufferChars

Numero di caratteri wide in Buffer.

[out] BufferNeeded

Numero di caratteri wide che questa funzione deve completare correttamente.

Valore restituito

DebugExtensionQueryValueNames potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	La funzione è stata completata correttamente.
S_FALSE	La funzione è stata completata senza errori, ma ha ottenuto solo risultati parziali.

Questa funzione potrebbe anche restituire valori di errore. Per altre informazioni sui possibili valori restituiti, vedere Valori restituiti.

Commenti

I nomi di valore devono iniziare con $$ e avere un carattere NULL di terminazione. Anche la stringa buffer deve essere con terminazione NULL. Ad esempio, Buffer potrebbe essere "$$myval 1\0$$myval 2\0\0".

DebugExtensionQueryValueNames viene chiamato PDEBUG_EXTENSION_QUERY_VALUE_NAMES nel file di intestazione Dbgeng.h.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h

Vedi anche

DebugExtensionInitialize

DebugExtensionNotify

DebugExtensionProvideValue

DebugExtensionUninitialize

KnownStructOutput

Condividi tramite