Metodo IDebugAdvanced3::Request (dbgeng.h)

Articolo
02/26/2024

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. La richiesta può essere uno dei valori della 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	Restituire il contesto del thread per l'evento archiviato in un file minidump in modalità utente.
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	Restituire l'ID del thread del sistema operativo per l'evento archiviato in un file minidump in modalità utente.
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	Restituire 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 del processo predefinite.
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS	Impostare le opzioni di creazione del processo predefinite.
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 scollegare il motore del debugger dal processo corrente (lasciando il processo in esecuzione ma non più sottoposto a debug).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Impostare la riga di comando implicita del motore del debugger.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Restituire il puntatore alle istruzioni dell'evento corrente.
DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM	Restituire fino a 64 byte di memoria nel puntatore alle istruzioni dell'evento corrente.
DEBUG_REQUEST_EXT_TYPED_DATA_ANSI	Eseguire un'ampia gamma di operazioni diverse che aiutano nell'interpretazione dei dati tipiti.

[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 che sia esattamente quella 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 . A meno che non venga specificato diversamente, i valori seguenti possono essere restituiti.

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, l'output non si adatta al buffer di output OutBuffer, quindi l'output troncato è stato restituito.
E_INVALIDARG	Le dimensioni del buffer di input InBufferSize o le dimensioni del buffer di output OutBufferSize non erano il valore previsto.