Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Подпрограмма 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 возвращает код состояния из следующего списка:
Код возврата | Описание |
---|---|
|
Указывает, что WMI удалось успешно выполнить эту функцию. |
|
Указывает, что службы WMI недоступны. |
|
Указывает, что недостаточно ресурсов для предоставления вызывающей стороны буфера, содержащего строку Юникода. |
|
Указывает, что недостаточно ресурсов для предоставления вызывающей стороны буфера, содержащего строку Юникода. |
Комментарии
Если параметр CombineNames имеет значение TRUE , необходимо указать как PhysicalDeviceObject , так и SymbolicLinkName . В противном случае следует указать только один из них.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно начиная с Windows 2000. |
Целевая платформа | Универсальное |
Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
Библиотека | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |