CM_Locate_DevNode_ExA函式 (cfgmgr32.h)

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

CM_Locate_DevNode_Ex函式會在本機計算機或遠端電腦上，取得與指定裝置實例標識符相關聯的裝置節點裝置實例句柄。

語法

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

參數

[out] pdnDevInst

[in, optional] pDeviceID

[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結構。

傳回值

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

備註

如需使用系結至本機或遠端電腦的裝置實例句柄的相關信息，請參閱 CM_Get_Child_Ex。

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

規格需求

另請參閱

CM_Get_Child_Ex
CM_Locate_DevNode