共用方式為

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