PDEBUG_EXTENSION_QUERY_VALUE_NAMES função de retorno de chamada (dbgeng.h)

Artigo
02/06/2025

A função de retorno de chamada DebugExtensionQueryValueNames recupera valores de de pseudo-registro.

 CALLBACK* PDEBUG_EXTENSION_QUERY_VALUE_NAMES DebugExtensionQueryValueNames;

Sintaxe

PDEBUG_EXTENSION_QUERY_VALUE_NAMES PdebugExtensionQueryValueNames;

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

Parâmetros

[in] Client

Um cliente a ser usado se a extensão precisar de funções DbgEng.

[in] Flags

Fornece sinalizadores comportamentais. Este parâmetro está reservado no momento.

[out] Buffer

Um buffer de cadeia de caracteres que o chamador fornece, a ser preenchido com o conjunto de nomes de valor que o cliente deseja expor.

[in] BufferChars

A contagem de caracteres largos no buffer .

[out] BufferNeeded

O número de caracteres largos que essa função precisa concluir com êxito.

Valor de retorno

DebugExtensionQueryValueNames pode retornar um dos seguintes valores:

Código de retorno	Descrição
S_OK	A função foi concluída com êxito.
S_FALSE	A função foi concluída sem erros, mas obteve apenas resultados parciais.

Essa função também pode retornar valores de erro. Para obter mais informações sobre possíveis valores retornados, consulte Valores retornados.

Observações

Os nomes de valor devem começar com $$ e ter um caractere NULL de terminação. A cadeia de caracteres de do Buffer também deve ser terminada em NULL. Por exemplo, buffer pode ser "$$myval 1\0$$myval 2\0\0".

DebugExtensionQueryValueNames é chamado PDEBUG_EXTENSION_QUERY_VALUE_NAMES no arquivo de cabeçalho Dbgeng.h.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h

Consulte também

DebugExtensionInitialize

DebugExtensionNotify

DebugExtensionProvideValue

DebugExtensionUninitialize

KnownStructOutput

Partilhar via