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

Article
02/23/2024

La méthode Request effectue différentes opérations.

Syntaxe

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

Paramètres

[in] Request

Spécifie l’opération à effectuer. La requête peut être l’une des valeurs du tableau suivant. Vous trouverez les détails de chaque opération en suivant le lien dans la colonne « Demande ».

Requête	Action
DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER	Vérifiez le chemin d’accès source d’un serveur source.
DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT	Retourne le contexte de thread pour l’événement stocké dans un fichier minidump en mode utilisateur.
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	Retourne l’ID de thread du système d’exploitation pour l’événement stocké dans un fichier minidump en mode utilisateur.
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	Retourne l’enregistrement d’exception pour l’événement stocké dans un fichier minidump en mode utilisateur.
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	Retourne les options de création de processus par défaut.
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS	Définissez les options de création de processus par défaut.
DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS	Retourne la version de Windows en cours d’exécution sur la cible.
DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM	Lire un flux à partir d’une cible minidump en mode utilisateur.
DEBUG_REQUEST_TARGET_CAN_DETACH	Vérifiez s’il est possible pour le moteur du débogueur de se détacher du processus actuel (en laissant le processus en cours d’exécution mais plus en cours de débogage).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Définissez la ligne de commande implicite du moteur de débogueur.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Retourne le pointeur d’instructions de l’événement actuel.
DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM	Retourne jusqu’à 64 octets de mémoire au pointeur d’instruction de l’événement actuel.
DEBUG_REQUEST_EXT_TYPED_DATA_ANSI	Effectuez différentes opérations qui facilitent l’interprétation des données typées.

[in, optional] InBuffer

Spécifie l’entrée de cette méthode. Le type et l’interprétation de l’entrée dépendent du paramètre Request .

[in] InBufferSize

Spécifie la taille de la mémoire tampon d’entrée InBuffer. Si la requête ne nécessite aucune entrée, InBufferSize doit être défini sur zéro.

[out, optional] OutBuffer

Reçoit la sortie de cette méthode. Le type et l’interprétation de la sortie dépendent du paramètre Request . Si OutBuffer a la valeur NULL, la sortie n’est pas retournée.

[in] OutBufferSize

Spécifie la taille de la mémoire tampon de sortie OutBufferSize. Si le type de la sortie retournée à OutBuffer a une taille connue, OutBufferSize est généralement censé être exactement cette taille, même si OutBuffer a la valeur NULL.

[out, optional] OutSize

Reçoit la taille de la sortie retournée dans la mémoire tampon de sortie OutBuffer. Si OutSize a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

L’interprétation de la valeur de retour dépend de la valeur du paramètre Request . Sauf indication contraire, les valeurs suivantes peuvent être retournées.

Code de retour	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la sortie ne tient pas dans la mémoire tampon de sortie OutBuffer. La sortie tronquée a donc été retournée.
E_INVALIDARG	La taille de la mémoire tampon d’entrée InBufferSize ou la taille de la mémoire tampon de sortie OutBufferSize n’était pas la valeur attendue.