Método IDebugAdvanced3::Request (dbgeng.h)

Artigo
02/06/2025

O método solicitação de executa uma variedade de operações diferentes.

Sintaxe

HRESULT Request(
  [in]            ULONG  Request,
  [in, optional]  PVOID  InBuffer,
  [in]            ULONG  InBufferSize,
  [out, optional] PVOID  OutBuffer,
  [in]            ULONG  OutBufferSize,
  [out, optional] PULONG OutSize
);

Parâmetros

[in] Request

Especifica qual operação executar. de Solicitação pode ser um dos valores na tabela a seguir. Os detalhes de cada operação podem ser encontrados seguindo o link na coluna "Solicitação".

Pedir	Ação
DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER	Verifique o caminho de origem para um servidor de origem.
DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT	Retorne o de contexto de thread para o evento armazenado em um arquivo de minidump no modo de usuário.
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	Retorne a ID do thread do sistema operacional para o evento armazenado em um arquivo de minidump no modo de usuário.
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	Retorne o registro de exceção para o evento armazenado em um arquivo de minidump no modo de usuário.
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	Retorne as opções de criação de processo padrão.
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS	Defina as opções de criação do processo padrão.
DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS	Retorne a versão do Windows que está em execução no destino.
DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM	Leia um fluxo de um destino de minidump no modo de usuário.
DEBUG_REQUEST_TARGET_CAN_DETACH	Verifique se é possível desanexar o mecanismo do depurador do processo atual (deixando o processo em execução, mas não sendo mais depurado).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Defina o mecanismo de depurador linha de comando implícita.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Retorne o ponteiro de instrução do evento atual.
DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM	Retorne até 64 bytes de memória no ponteiro de instrução do evento atual.
DEBUG_REQUEST_EXT_TYPED_DATA_ANSI	Execute uma variedade de operações diferentes que ajudam na interpretação de dados tipado.

[in, optional] InBuffer

Especifica a entrada para esse método. O tipo e a interpretação da entrada dependem do parâmetro de solicitação de.

[in] InBufferSize

Especifica o tamanho do buffer de entrada InBuffer. Se a solicitação não exigir nenhuma entrada, InBufferSize deverá ser definido como zero.

[out, optional] OutBuffer

Recebe a saída desse método. O tipo e a interpretação da saída dependem do parâmetro Request. Se do OutBuffer for NULL, a saída não será retornada.

[in] OutBufferSize

Especifica o tamanho do buffer de saída OutBufferSize. Se o tipo da saída retornada para OutBuffer tiver um tamanho conhecido, OutBufferSize geralmente deverá ser exatamente desse tamanho, mesmo que outbuffer esteja definido como NULL.

[out, optional] OutSize

Recebe o tamanho da saída retornada no buffer de saída OutBuffer. Se outSize for NULL, essas informações não serão retornadas.

Valor de retorno

A interpretação do valor retornado depende do valor do parâmetro Request. A menos que indicado de outra forma, os valores a seguir poderão ser retornados.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, a saída não caberia no buffer de saída OutBuffer; portanto, a saída truncada foi retornada.
E_INVALIDARG	O tamanho do buffer de entrada InBufferSize ou o tamanho do buffer de saída OutBufferSize não era o valor esperado.