функция CM_Locate_DevNode_ExW (cfgmgr32.h)

Статья
03/08/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, или дескриптор компьютера, к которому привязан набор сведений об устройстве. Дескриптор компьютера для набора сведений об устройстве получается из элемента RemoteMachineHandleструктуры SP_DEVINFO_LIST_DETAIL_DATA для набора сведений об устройстве. Вызовите SetupDiGetDeviceInfoListDetail , чтобы получить структуру SP_DEVINFO_LIST_DETAIL_DATA.

Примечание Использование этой функции для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.

Возвращаемое значение

Если операция выполнена успешно, CM_Locate_DevNode возвращает CR_SUCCESS. В противном случае функция возвращает один из кодов ошибок с CR_ префиксами, определенных в Cfgmgr32.h.

Функциональные возможности доступа к удаленным компьютерам были удалены в операционных системах Windows 8 и Windows Server 2012 и более поздних версиях, поэтому вы не сможете получить доступ к удаленным компьютерам при работе в этих версиях Windows.

Требования


Минимальная версия клиента	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	cfgmgr32.h (включая Cfgmgr32.h)
Библиотека	Cfgmgr32.lib

См. также раздел

CM_Get_Child_Ex

CM_Locate_DevNode

Поделиться через