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 會從下列清單中傳回狀態代碼：

傳回碼 Description
STATUS_SUCCESS
 表示 WMI 能夠順利完成此函式。
STATUS_UNSUCCESSFUL
 表示無法使用 WMI 服務。
STATUS_INSUFFICIENT_RESOURCES
 表示資源不足，無法提供呼叫端包含 Unicode 字串的緩衝區。
STATUS_NO_MEMORY
 表示資源不足，無法提供呼叫端包含 Unicode 字串的緩衝區。

備註

如果 CombineNames 參數為 TRUE ，則必須指定 PhysicalDeviceObject 和 SymbolicLinkName 。 否則，應該只指定其中一個。

規格需求

需求 值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

IoWMIAllocateInstanceIds