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

Статья
08/22/2023

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

Примечание

В Windows Vista и более поздних версиях Windows унифицированная модель свойств устройства использует ключ свойства DEVPKEY_Device_InstanceId для представления идентификатора экземпляра устройства. Дополнительные сведения см. в разделе Получение идентификатора экземпляра устройства .

Синтаксис

CMAPI CONFIGRET CM_Get_Device_IDW(
  [in]  DEVINST dnDevInst,
  [out] PWSTR   Buffer,
  [in]  ULONG   BufferLen,
  [in]  ULONG   ulFlags
);

Параметры

[in] dnDevInst

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

[out] Buffer

Адрес буфера для получения строки идентификатора экземпляра устройства. Требуемый размер буфера можно получить, вызвав CM_Get_Device_ID_Size, а затем увеличив полученное значение, чтобы освободить место для завершающего значения NULL строки.

[in] BufferLen

Указанная вызывающим объектом длина буфера, заданного параметром Buffer, в символах.

[in] ulFlags

Не используется, должно быть равно нулю.

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

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

Функция добавляет признак конца NULL к предоставленной строке идентификатора экземпляра устройства, если буфер не слишком мал для хранения строки. В этом случае функция предоставляет столько строки идентификатора, сколько поместится в буфер, а затем возвращает CR_BUFFER_SMALL.

Сведения об идентификаторах экземпляров устройств см. в разделе Строки идентификации устройств.

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

Требования

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

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

CM_Get_Child

CM_Get_Device_ID_Ex

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