CM_Locate_DevNode_ExW函式 (cfgmgr32.h)

發行項
08/22/2023

[從 Windows 8 和 Windows Server 2012 開始，此函式已被取代。請改用 CM_Locate_DevNode 。]

CM_Locate_DevNode_Ex函式會在本機電腦或遠端電腦上，取得與指定裝置實例識別碼相關聯的裝置節點的裝置實例控制碼。

語法

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

參數

[out] pdnDevInst

此函式所擷取之裝置實例控制碼的指標。擷取的控制碼會系結至 hMachine所指定的機器控制碼。

[in, optional] pDeviceID

代表裝置實例識別碼之 Null 終止字串的指標。如果此值為 Null，或指向長度為零的字串，函式會將裝置實例控制碼提供給裝置樹狀結構根目錄的裝置。

[in] ulFlags

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

CM_LOCATE_DEVNODE_NORMAL

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

CM_LOCATE_DEVNODE_PHANTOM

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

CM_LOCATE_DEVNODE_CANCELREMOVE

如果裝置目前是在裝置樹狀結構中設定，或是在裝置樹狀結構中移除的程式中，函式會擷取指定裝置的裝置實例控制碼。如果裝置正在移除，函式會取消移除裝置。

CM_LOCATE_DEVNODE_NOVALIDATION

未使用。

[in, optional] hMachine

從呼叫 CM_Connect_Machine取得的電腦控制碼，或裝置資訊集所系結的電腦控制碼。裝置資訊集的電腦控制碼是從裝置資訊集之 SP_DEVINFO_LIST_DETAIL_DATA結構的RemoteMachineHandle成員取得。呼叫 SetupDiGetDeviceInfoListDetail 以取得SP_DEVINFO_LIST_DETAIL_DATA結構。

注意從 Windows 8 和 Windows Server 2012 開始，不支援使用此函式來存取遠端電腦，因為此功能已移除。

傳回值

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

備註

如需使用系結至本機或遠端電腦之裝置實例控制碼的相關資訊，請參閱 CM_Get_Child_Ex。

存取遠端電腦的功能已在 Windows 8 和 Windows Server 2012 和更新版本中移除，因此您無法在這些版本的 Windows 上執行時存取遠端電腦。

規格需求


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

另請參閱

CM_Get_Child_Ex

CM_Locate_DevNode

共用方式為