IDebugAdvanced2 ::Request, méthode (dbgeng.h)

Article
02/06/2025

La méthode Request effectue diverses 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. 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 ».

Demander	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	Retournez 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 de l’événement stocké dans un fichier minidump en mode utilisateur.
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	Retournez 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	Retournez 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 que le moteur du débogueur se détache du processus actuel (laissant le processus en cours d’exécution, mais n’étant plus débogué).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Définissez le moteur de débogueur ligne de commande implicite.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Retourne le pointeur d’instruction 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 diverses 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 demande 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 Requête. Si OutBuffer est 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 sortie retourné à OutBuffer a une taille connue, OutBufferSize est généralement censé être exactement cette taille, même si OutBuffer est défini sur NULL.

[out, optional] OutSize

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

Valeur de retour

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

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la sortie ne s’adapterait pas à la mémoire tampon de sortie OutBuffer, de sorte que la sortie tronquée a é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.