Méthode IDebugClient5 ::GetDumpFile (dbgeng.h)

  • Article

La méthode GetDumpFile décrit les fichiers contenant des informations de prise en charge qui ont été utilisés lors de l’ouverture de la cible de vidage actuelle.

Syntaxe

HRESULT GetDumpFile(
  [in]            ULONG    Index,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Handle,
  [out]           PULONG   Type
);

Paramètres

[in] Index

Spécifie le fichier à décrire. Index peut prendre des valeurs comprises entre zéro et le nombre de fichiers moins un ; Le nombre de fichiers peut être trouvé à l’aide de GetNumberDumpFiles.

[out, optional] Buffer

Reçoit le nom du fichier. Si Buffer a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille en caractères de la mémoire tampon. Cette taille inclut l’espace pour le caractère de fin « \0 ».

[out, optional] NameSize

Reçoit la taille du nom de fichier. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si NameSize a la valeur NULL, ces informations ne sont pas retournées.

[out, optional] Handle

Reçoit le handle de fichier du fichier. Si Handle a la valeur NULL, ces informations ne sont pas retournées.

[out] Type

Reçoit le type du fichier.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour Description
S_OK
 La méthode a réussi.

Remarques

Pour plus d’informations sur les fichiers de vidage sur incident, consultez Dump-File Targets.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)

Voir aussi

AddDumpInformationFile

AddDumpInformationFileWide

GetNumberDumpFiles

IDebugClient4

IDebugClient5