Метод IDebugDataSpaces2::ReadHandleData (dbgeng.h)

Статья
02/06/2025

Метод ReadHandleData извлекает сведения о системном объекте, указанном системным дескриптором.

Синтаксис

HRESULT ReadHandleData(
  [in]            ULONG64 Handle,
  [in]            ULONG   DataType,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  DataSize
);

Параметры

[in] Handle

Указывает системный дескриптор объекта, данные которого запрашивается. Сведения о системных дескрипторах см. в разделе "Дескрипторы".

[in] DataType

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

Ценность	Описание
DEBUG_HANDLE_DATA_TYPE_BASIC	Возвращает основные сведения о системных объектах. В этом случае аргумент буфера можно считать типом PDEBUG_HANDLE_DATA_BASIC.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME	Возвращает имя типа объекта. Например, "Process" или "Thread". В этом случае аргумент буфера можно считать типом PSTR.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME	Возвращает имя объекта. Это включает его расположение в каталоге объектов. В этом случае аргумент буфера можно считать типом PSTR.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT	Возвращает количество дескрипторов, удерживаемых объектом. Это похоже на поле DEBUG_HANDLE_DATA_BASIC.HandleCount. В этом случае аргумент буфера можно считать типом PULONG.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE	Возвращает имя типа объекта. В этом случае аргумент буфера можно считать типом PWSTR
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	Возвращает имя объекта. В этом случае аргумент буфера можно считать типом PWSTR.

[out, optional] Buffer

Получает данные объекта. После успешного завершения метода содержимое этого буфера можно получить путем приведения буфера к типу, указанному в приведенной выше таблице.

Если буферnull, эти сведения не возвращаются.

[in] BufferSize

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

[out, optional] DataSize

Получает размер данных в байтах. Если DataSizeNULL, эти сведения не возвращаются.

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

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

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

Замечания

Этот метод доступен только в отладке в пользовательском режиме.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	dbgeng.h (include Dbgeng.h)

См. также

Ручки

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

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