CM_Locate_DevNodeA函式 (cfgmgr32.h)
CM_Locate_DevNode函式會取得裝置實例控制碼，該裝置節點與本機電腦上的指定裝置實例識別碼相關聯。
語法
CMAPI CONFIGRET CM_Locate_DevNodeA(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_A 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 |