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

El método GetSourceFileInformation devuelve información especificada sobre un archivo de origen.

Sintaxis

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 el fragmento de información que se va a devolver. El parámetro Which puede tomar uno de los valores de la tabla siguiente.

DEBUG_SRCFILE_SYMBOL_TOKEN

Devuelve un token que representa el archivo de origen especificado en un servidor de origen. Este token se puede pasar a FindSourceFileAndToken para recuperar información sobre el archivo. El token se devuelve al búfer de búfer como una matriz de bytes. El tamaño de este token es una reflexión del tamaño del token SrcSrv.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

Consulta un servidor de origen para que el comando extraiga el archivo de código fuente del control de código fuente. Esto incluye el nombre del archivo ejecutable y sus parámetros de línea de comandos. El comando se devuelve al búfer de búfer como una cadena Unicode.

[in] SourceFile

Especifica el archivo de origen cuya información se solicita. El archivo de origen se busca en todos los servidores de origen de la ruta de acceso de origen.

[in] Arg64

Especifica un argumento de 64 bits. El valor de Which especifica el módulo cuyo token de símbolo se solicita. Independientemente del valor de Which, Arg64 es una ubicación dentro de la asignación de memoria del módulo.

[in] Arg32

Especifica un argumento de 32 bits. Este parámetro no se usa actualmente.

[out, optional] Buffer

Recibe la información de símbolo solicitada. El tipo de los datos devueltos depende del valor de Which. Si Buffer es NULL, no se devuelve esta información.

[in] BufferSize

Especifica el tamaño en bytes del búfer de búfer . Si Buffer es NULL, BufferSize también debe ser NULL.

[out, optional] InfoSize

Especifica el tamaño en bytes de la información devuelta al búfer de búfer . Este parámetro puede ser NULL si los datos no son necesarios.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, la información no cabería en el búfer de búfer , por lo que la información o el nombre se truncaron.

Comentarios

Para obtener más información sobre los archivos de origen, vea Uso de archivos de código fuente.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	dbgeng.h (incluir Dbgeng.h)

Consulte también

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3