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

Artigo
08/07/2023

O método Request 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. A 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".

Solicitação	Ação
DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER	Verifique o caminho de origem de um servidor de origem.
DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT	Retornar o contexto de thread para o evento armazenado em um arquivo de minidespejo no modo de usuário.
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	Retornar a ID de thread do sistema operacional para o evento armazenado em um arquivo de minidespejo no modo de usuário.
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	Retornar o registro de exceção para o evento armazenado em um arquivo de minidespejo no modo de usuário.
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	Retornar as opções de criação de processo padrão.
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS	Defina as opções de criação de processo padrão.
DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS	Retorne a versão do Windows em execução no momento no destino.
DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM	Ler um fluxo de um destino de minidespejo no modo de usuário.
DEBUG_REQUEST_TARGET_CAN_DETACH	Verifique se é possível que o mecanismo do depurador se desanexe do processo atual (deixando o processo em execução, mas não sendo mais depurado).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Defina a linha de comando implícita do mecanismo de depurador.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Retornar 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 auxiliam 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 Request .

[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 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, espera-se que OutBufferSize seja exatamente esse 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.

Retornar valor

A interpretação do valor retornado depende do valor do parâmetro Request . A menos que indicado de outra forma, os valores a seguir podem 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 outBuffer do buffer de saída, 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.