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

O método GetDumpFile descreve os arquivos que contêm informações de suporte que foram usadas ao abrir o destino de despejo atual.

Sintaxe

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

Parâmetros

[in] Index

Especifica qual arquivo descrever. O índice pode obter valores entre zero e o número de arquivos menos um; o número de arquivos pode ser encontrado usando GetNumberDumpFiles.

[out, optional] Buffer

Recebe o nome do arquivo. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho em caracteres do buffer Buffer. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] NameSize

Recebe o tamanho do nome do arquivo. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se NameSize for NULL, essas informações não serão retornadas.

[out, optional] Handle

Recebe o identificador de arquivo do arquivo. Se Handle for NULL, essas informações não serão retornadas.

[out] Type

Recebe o tipo do arquivo.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Para obter mais informações sobre arquivos de despejo de memória, consulte Destinos de arquivo de despejo.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	dbgeng.h (inclua Dbgeng.h)

Confira também

AddDumpInformationFile

AddDumpInformationFileWide

GetNumberDumpFiles

IDebugClient4

IDebugClient5