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

Функция IoWMIHandleToInstanceName (wdm.h)

Подпрограмма IoWMIHandleToInstanceName определяет имя экземпляра для экземпляра класса WMI, реализованного драйвером, указанным дескриптором файла.

Синтаксис

NTSTATUS IoWMIHandleToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  HANDLE          FileHandle,
  [out] PUNICODE_STRING InstanceName
);

Параметры

[in] DataBlockObject

Указатель на объект блока данных WMI. Вызывающий объект открывает объект блока данных для класса WMI с помощью подпрограммы IoWMIOpenBlock.

[in] FileHandle

Задает дескриптор файла. Подпрограмма возвращает имя экземпляра, соответствующее драйверу, представленному дескриптором файла.

[out] InstanceName

Указатель на структуру UNICODE_STRING, которую подпрограмма использует для возврата имени экземпляра. Вызывающий объект освобождает возвращенный буфер в UNICODE_STRING.

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

Подпрограмма возвращает код NTSTATUS. Возможные возвращаемые значения:

Возвращаемый код Описание
STATUS_SUCCESS
 Операция завершилась успешно. Подпрограмма заполняет структуру UNICODE_STRING, на которую указывает параметр InstanceName с именем экземпляра.
STATUS_WMI_INSTANCE_NOT_FOUND
 Драйвер не реализует экземпляры класса WMI, указанного DataBlockObject.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно в Windows XP и более поздних версиях операционной системы Windows.
целевая платформа Всеобщий
заголовка wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

См. также

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock

  • Last updated on