通过

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
 指示资源不足，无法向调用方提供包含 Unicode 字符串的缓冲区。
STATUS_NO_MEMORY
 指示资源不足，无法向调用方提供包含 Unicode 字符串的缓冲区。

言论

如果 CombineNames 参数 TRUE，则必须同时指定 PhysicalDeviceObject 和 SymbolicLinkName。 否则，应只指定其中一个。

要求

要求 价值
最低支持的客户端 从 Windows 2000 开始可用。
目标平台 普遍
标头 wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h）
库 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

IoWMIAllocateInstanceIds