CM_Locate_DevNodeW函式 (cfgmgr32.h)

CM_Locate_DevNode函式會取得與本機計算機上指定裝置實例標識符相關聯的裝置節點裝置實例句柄。

語法

CMAPI CONFIGRET CM_Locate_DevNodeW(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags
);

參數

[out] pdnDevInst

CM_Locate_DevNode擷取之裝置實例句柄的指標。 擷取的句柄會系結至本機計算機。

[in, optional] pDeviceID

代表 裝置實例標識碼之 NULL 終止字串的指標。 如果此值為 NULL，或指向長度為零的字串，函式會擷取裝置實例句柄到裝置樹狀結構根目錄的 裝置。

[in] ulFlags

ULONG 類型的變數，提供下列其中一個旗標值，如果呼叫端提供裝置實例識別符，則適用：

CM_LOCATE_DEVNODE_NORMAL

函式只會擷取指定裝置的裝置實例句柄，只有在裝置樹狀結構中目前已設定裝置時。

CM_LOCATE_DEVNODE_PHANTOM

如果裝置目前已在裝置樹狀結構中設定，或裝置是裝置樹狀結構中目前未設定的裝置，則函式會擷取指定裝置的裝置實例句柄。

CM_LOCATE_DEVNODE_CANCELREMOVE

如果裝置目前已在裝置樹狀結構中設定，或從裝置樹狀結構中移除的程式，函式會擷取指定裝置的裝置實例句柄。 如果裝置正在移除，函式會取消移除裝置。

CM_LOCATE_DEVNODE_NOVALIDATION

未使用。

傳回值

如果作業成功， CM_Locate_DevNode 傳回CR_SUCCESS。 否則，函式會傳回 Cfgmgr32.h 中定義的其中一個CR_Xxx 錯誤碼。

備註

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

注意

cfgmgr32.h 標頭會將CM_Locate_DevNode定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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

另請參閱

CM_Get_Child

CM_Locate_DevNode_Ex