Metodo IDebugAdvanced3::Request (dbgeng.h)

Articolo
02/06/2025

Il metodo Request esegue un'ampia gamma di operazioni diverse.

Sintassi

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

Parametri

[in] Request

Specifica l'operazione da eseguire. richiesta può essere uno dei valori riportati nella tabella seguente. I dettagli di ogni operazione sono disponibili seguendo il collegamento nella colonna "Richiesta".

Richiesta	Azione
DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER	Controllare il percorso di origine per un server di origine.
DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT	Restituisce il contesto del thread per l'evento archiviato in un file minidump in modalità utente.
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	Restituisce l'ID thread del sistema operativo per l'evento archiviato in un file minidump in modalità utente.
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	Restituisce il record di eccezione per l'evento archiviato in un file minidump in modalità utente.
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	Restituisce le opzioni di creazione predefinite del processo.
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS	Impostare le opzioni di creazione predefinite del processo.
DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS	Restituisce la versione di Windows attualmente in esecuzione nella destinazione.
DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM	Leggere un flusso da una destinazione minidump in modalità utente.
DEBUG_REQUEST_TARGET_CAN_DETACH	Verificare se è possibile che il motore del debugger si disconnette dal processo corrente (lasciando il processo in esecuzione ma non più sottoposto a debug).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Impostare il motore del debugger riga di comando implicita.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Restituisce il puntatore all'istruzione dell'evento corrente.
DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM	Restituisce fino a 64 byte di memoria nel puntatore all'istruzione dell'evento corrente.
DEBUG_REQUEST_EXT_TYPED_DATA_ANSI	Eseguire un'ampia gamma di operazioni diverse che facilitano l'interpretazione dei dati tipizzato.

[in, optional] InBuffer

Specifica l'input per questo metodo. Il tipo e l'interpretazione dell'input dipendono dal parametro request.

[in] InBufferSize

Specifica le dimensioni del buffer di input InBuffer. Se la richiesta non richiede alcun input, InBufferSize deve essere impostato su zero.

[out, optional] OutBuffer

Riceve l'output da questo metodo. Il tipo e l'interpretazione dell'output dipendono dal parametro Request. Se OutBuffer è NULL, l'output non viene restituito.

[in] OutBufferSize

Specifica le dimensioni del buffer di output OutBufferSize. Se il tipo dell'output restituito a OutBuffer ha una dimensione nota, OutBufferSize è in genere previsto esattamente tale dimensione, anche se OutBuffer è impostato su NULL.

[out, optional] OutSize

Riceve le dimensioni dell'output restituito nel buffer di output OutBuffer. Se OutSize è null, queste informazioni non vengono restituite.

Valore restituito

L'interpretazione del valore restituito dipende dal valore del parametro Request. Se non diversamente specificato, è possibile che vengano restituiti i valori seguenti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo. Tuttavia, l'output non rientra nel buffer di output OutBuffer, quindi è stato restituito l'output troncato.
E_INVALIDARG	Le dimensioni del buffer di input InBufferSize o le dimensioni del buffer di output OutBufferSize non erano il valore previsto.