CM_Get_DevNode_Status 函式 (cfgmgr32.h)

CM_Get_DevNode_Status函式會從裝置節點取得裝置實例的狀態, (本機計算機裝置樹狀目錄中的 devnode) 。

注意

在 Windows Vista 和更新版本中, 統一裝置屬性模型 會使用 DEVPKEY_Device_DevNodeStatus屬性索引鍵 來表示裝置實例識別碼。 如需詳細資訊,請參閱 擷取裝置實例的狀態和問題碼

語法

CMAPI CONFIGRET CM_Get_DevNode_Status(
  [out] PULONG  pulStatus,
  [out] PULONG  pulProblemNumber,
  [in]  DEVINST dnDevInst,
  [in]  ULONG   ulFlags
);

參數

[out] pulStatus

接收狀態位旗標的位置位址。 函式可以設定在 Cfg.h 中定義的DN_前置位旗標的任何組合。

[out] pulProblemNumber

要接收 Cfg.h 中定義的其中一個CM_PROB_前置問題值的位置位址。 只有在 pulStatus 中設定DN_HAS_PROBLEM時才使用。

[in] dnDevInst

呼叫端提供的裝置實例句柄,該句柄系結至本機計算機。

[in] ulFlags

未使用,必須是零。

傳回值

如果作業成功,函式會傳回CR_SUCCESS。 否則,它會傳回 Cfgmgr32.h 中定義的其中一個CR_前置錯誤碼。

備註

如需使用系結至本機計算機的裝置實例句柄的相關信息,請參閱 CM_Get_Child

規格需求

需求
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 cfgmgr32.h (包含 Cfgmgr32.h)
程式庫 Cfgmgr32.lib;Windows 10 上的 OneCoreUAP.lib
Dll CfgMgr32.dll

另請參閱

CM_Get_Child

CM_Get_DevNode_Status_Ex