Compartilhar via


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

O método GetDumpFile descreve os arquivos que contêm informações de suporte 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. índice pode levar 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.

Valor de retorno

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

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

Observações

Para obter mais informações sobre arquivos de despejo de falhas, consulte Dump-File Targets.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

AddDumpInformationFile

AddDumpInformationFileWide

GetNumberDumpFiles

IDebugClient4

IDebugClient5