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

Статья
11/20/2024

Функция CM_Locate_DevNode получает дескриптор экземпляра устройства к узлу устройства, связанному с указанным идентификатором экземпляра устройства на локальном компьютере.

Синтаксис

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

Параметры

[out] pdnDevInst

Указатель на дескриптор экземпляра устройства, который CM_Locate_DevNode извлекается. Извлекаемая дескриптор привязана к локальному компьютеру.

[in, optional] pDeviceID

Указатель на строку, завершающую значение NULL, представляющую идентификатор экземпляра устройства . Если это значение равно nullили если оно указывает на строку нулевой длины, функция извлекает дескриптор экземпляра устройства в корне дерева устройств .

[in] ulFlags

Переменная типа ULONG, которая предоставляет одно из следующих значений флагов, которые применяются, если вызывающий предоставляет идентификатор экземпляра устройства:

CM_LOCATE_DEVNODE_NORMAL

Функция извлекает дескриптор экземпляра устройства для указанного устройства, только если устройство настроено в дереве устройств.

CM_LOCATE_DEVNODE_PHANTOM

Функция извлекает дескриптор экземпляра устройства для указанного устройства, если устройство настроено в дереве устройств или устройство является непредставленным устройством, которые в настоящее время не настроены в дереве устройств.

CM_LOCATE_DEVNODE_CANCELREMOVE

Функция извлекает дескриптор экземпляра устройства для указанного устройства, если устройство в настоящее время настроено в дереве устройства или в процессе удаления из дерева устройств. Если устройство находится в процессе удаления, функция отменяет удаление устройства.

CM_LOCATE_DEVNODE_NOVALIDATION

Не используется.

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

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

Замечания

Сведения об использовании дескрипторов экземпляра устройства, привязанных к локальному компьютеру, см. в CM_Get_Child.

Заметка

Заголовок cfgmgr32.h определяет CM_Locate_DevNode как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
целевая платформа	Всеобщий
заголовка	cfgmgr32.h (include Cfgmgr32.h)
библиотеки	Cfgmgr32.lib
DLL	CfgMgr32.dll

См. также

CM_Get_Child

CM_Locate_DevNode_Ex

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