CM_Locate_DevNode_ExW函数 (cfgmgr32.h)
[从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结构。
返回值
如果操作成功， 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 |