Compartilhar via


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

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 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

Retornar o registro de exceção do evento armazenado em um arquivo de minidump 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 que está em execução no momento 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 mais sendo 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 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.
 

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS

DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET

DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS

DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM

DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM

DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS

DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE

DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER

DEBUG_REQUEST_TARGET_CAN_DETACH

DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT

DEBUG_REQUEST_TARGET_EXCEPTION_RECORD

DEBUG_REQUEST_TARGET_EXCEPTION_THREAD

IDebugAdvanced2

IDebugAdvanced3