Метод IDebugDataSpaces4::ReadTagged (dbgeng.h)

Статья
02/06/2025

Метод ReadTagged считывает помеченные данные, которые могут быть связаны с сеансом отладчика.

Синтаксис

HRESULT ReadTagged(
  [in]            LPGUID Tag,
  [in]            ULONG  Offset,
  [out, optional] PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG TotalSize
);

Параметры

[in] Tag

Указывает GUID, определяющий запрошенные данные.

[in] Offset

Указывает смещение в данных для чтения.

[out, optional] Buffer

Получает данные. Если буферзначение NULL, данные не возвращаются.

[in] BufferSize

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

[out, optional] TotalSize

Получает общий размер в байтах данных, указанных тегом.

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

Возвращаемый код	Описание
S_OK	Метод был успешным.
E_NOINTERFACE	Данные, идентифицированные тегом, не найдены.

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

Замечания

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

LPGUID — это указатель на 128-разрядный уникальный идентификатор. Он определен в файле заголовка пакета SDK Для Microsoft Windows guiddef.h.