Метод IDebugAdvanced3::GetSourceFileInformation (dbgeng.h)

Статья
02/23/2024

Метод GetSourceFileInformation возвращает указанные сведения об исходном файле.

Синтаксис

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
);

Параметры

[in] Which

Указывает возвращаемый фрагмент информации. Параметр Which может принимать одно из значений, приведенных в следующей таблице.

DEBUG_SRCFILE_SYMBOL_TOKEN

Возвращает маркер, представляющий указанный исходный файл на исходном сервере. Этот маркер можно передать в FindSourceFileAndToken для получения сведений о файле. Маркер возвращается в буфер буфера в виде массива байтов. Размер этого маркера отражает размер токена SrcSrv.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

Запрашивает у исходного сервера команду для извлечения исходного файла из системы управления версиями. Сюда входит имя исполняемого файла и его параметры командной строки. Команда возвращается в буфер буфера в виде строки Юникода.

[in] SourceFile

Указывает исходный файл, сведения о котором запрашиваются. Исходный файл выполняется на всех исходных серверах в исходном пути.

[in] Arg64

Задает 64-разрядный аргумент. Значение Параметра Which указывает модуль, маркер символа которого запрашивается. Независимо от значения Параметра,Arg64 является расположением в выделении памяти модуля.

[in] Arg32

Задает 32-разрядный аргумент. Этот параметр в настоящее время не используется.

[out, optional] Buffer

Получает запрошенные сведения о символах. Тип возвращаемых данных зависит от значения Параметра. Если параметр Buffer имеет значение NULL, эти сведения не возвращаются.

[in] BufferSize

Задает размер буфера буфера в байтах. Если buffer имеет значение NULL, bufferSize также должен иметь значение NULL.

[out, optional] InfoSize

Задает размер в байтах сведений, возвращаемых буферу буфера. Этот параметр может иметь значение NULL , если данные не требуются.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Метод выполнен успешно. Однако эти сведения не помещаются в буфер буфера , поэтому сведения или имя были усечены.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h)

См. также раздел

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3

Поделиться через