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 |
|---|---|
|
O método foi bem-sucedido. |
|
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) |