CM_Locate_DevNode_ExW 函数 (cfgmgr32.h)

项目
08/22/2023

[从 Windows 8 和 Windows Server 2012 开始，此函数已弃用。请改用 CM_Locate_DevNode 。]

CM_Locate_DevNode_Ex 函数在本地计算机或远程计算机上获取与指定设备实例 ID 关联的设备节点的设备实例句柄。

语法

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

指向表示设备实例 ID 的以 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)
Library	Cfgmgr32.lib

另请参阅

CM_Get_Child_Ex

CM_Locate_DevNode

通过