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

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

  • Статья

Метод 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 Возвращает основные сведения о системных объектах.

В этом случае аргумент Buffer можно считать типом PDEBUG_HANDLE_DATA_BASIC.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME Возвращает имя типа объекта. Например, "Process" или "Thread".

В этом случае аргумент Buffer можно считать типом PSTR.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME Возвращает имя объекта . Сюда входит его расположение в каталоге объекта.

В этом случае аргумент Buffer можно считать типом PSTR.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT Возвращает количество дескрипторов, удерживаемых объектом . Это похоже на поле DEBUG_HANDLE_DATA_BASIC. HandleCount.

В этом случае аргумент Buffer можно считать типом PULONG.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE Возвращает имя типа объекта.

В этом случае аргумент Buffer можно считать типом PWSTR.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE Возвращает имя объекта .

В этом случае аргумент Buffer можно считать типом PWSTR.

[out, optional] Buffer

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

Если параметр Buffer имеет значение NULL, эта информация не возвращается.

[in] BufferSize

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

[out, optional] DataSize

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
 

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

Комментарии

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

Требования

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

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

Маркеры

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4