共用方式為

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 中提供。
目標平臺 普遍
標頭 cfgmgr32.h （包括 Cfgmgr32.h）
連結庫 Cfgmgr32.lib
DLL CfgMgr32.dll

另請參閱

CM_Get_Child

CM_Locate_DevNode_Ex