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

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

  • Статья

Подпрограмма IoWMISuggestInstanceName используется для запроса WMI предложить базовое имя, которое драйвер может использовать для создания имен экземпляров WMI для устройства.

Синтаксис

NTSTATUS IoWMISuggestInstanceName(
  [in, optional] PDEVICE_OBJECT  PhysicalDeviceObject,
  [in, optional] PUNICODE_STRING SymbolicLinkName,
  [in]           BOOLEAN         CombineNames,
  [out]          PUNICODE_STRING SuggestedInstanceName
);

Параметры

[in, optional] PhysicalDeviceObject

Если он указан, указывает на объект физического устройства драйвера.

[in, optional] SymbolicLinkName

Если он указан, указывает на символьное имя ссылки, возвращаемое из IoRegisterDeviceInterface.

[in] CombineNames

Если задано значение TRUE , предлагаемые имена будут объединять сведения PhysicalDeviceObject и SymbolicLinkName .

[out] SuggestedInstanceName

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

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

IoWMISuggestInstanceName возвращает код состояния из следующего списка:

Код возврата Описание
STATUS_SUCCESS
 Указывает, что WMI удалось успешно выполнить эту функцию.
STATUS_UNSUCCESSFUL
 Указывает, что службы WMI недоступны.
STATUS_INSUFFICIENT_RESOURCES
 Указывает, что недостаточно ресурсов для предоставления вызывающей стороны буфера, содержащего строку Юникода.
STATUS_NO_MEMORY
 Указывает, что недостаточно ресурсов для предоставления вызывающей стороны буфера, содержащего строку Юникода.

Комментарии

Если параметр CombineNames имеет значение TRUE , необходимо указать как PhysicalDeviceObject , так и SymbolicLinkName . В противном случае следует указать только один из них.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

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

IoWMIAllocateInstanceIds