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

Статья
02/23/2024

Метод 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

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

[in] BufferSize

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

[out, optional] TotalSize

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

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

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

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

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

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