Método IDebugAdvanced3::GetSourceFileInformation (dbgeng.h)

O método GetSourceFileInformation retorna informações especificadas sobre um arquivo de origem.

Sintaxe

HRESULT GetSourceFileInformation(
  [in]            ULONG   Which,
  [in]            PSTR    SourceFile,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Parâmetros

[in] Which

Especifica a informação a ser retornada. O parâmetro Which pode ter um dos valores na tabela a seguir.

DEBUG_SRCFILE_SYMBOL_TOKEN

Retorna um token que representa o arquivo de origem especificado em um servidor de origem. Esse token pode ser passado para FindSourceFileAndToken para recuperar informações sobre o arquivo. O token é retornado ao buffer de buffer como uma matriz de bytes. O tamanho desse token é um reflexo do tamanho do token SrcSrv.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

Consulta um servidor de origem para que o comando extraia o arquivo de origem do controle do código-fonte. Isso inclui o nome do arquivo executável e seus parâmetros de linha de comando. O comando é retornado ao buffer de buffer como uma cadeia de caracteres Unicode.

[in] SourceFile

Especifica o arquivo de origem cujas informações estão sendo solicitadas. O arquivo de origem é pesquisado em todos os servidores de origem no caminho de origem.

[in] Arg64

Especifica um argumento de 64 bits. O valor de Qual especifica o módulo cujo token de símbolo é solicitado. Independentemente do valor de Qual, Arg64 é um local dentro da alocação de memória do módulo.

[in] Arg32

Especifica um argumento de 32 bits. No momento, esse parâmetro não é usado.

[out, optional] Buffer

Recebe as informações de símbolo solicitadas. O tipo dos dados retornados depende do valor de Qual. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho em bytes do buffer de buffer. Se Buffer for NULL, BufferSize também deverá ser NULL.

[out, optional] InfoSize

Especifica o tamanho em bytes das informações retornadas para o buffer de buffer. Esse parâmetro poderá ser NULL se os dados não forem necessários.

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.
S_FALSE	O método foi bem-sucedido. No entanto, as informações não caberiam no buffer de buffer, portanto, as informações ou o nome foram truncados.

Comentários

Para obter mais informações sobre arquivos de origem, consulte Usando arquivos de origem.

Requisitos

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

Confira também

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3