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

Статья
08/22/2023

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

Примечание

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

Синтаксис

CMAPI CONFIGRET CM_Get_Device_ID_Size(
  [out] PULONG  pulLen,
  [in]  DEVINST dnDevInst,
  [in]  ULONG   ulFlags
);

Параметры

[out] pulLen

Получает значение, представляющее требуемый размер буфера в символах.

[in] dnDevInst

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

[in] ulFlags

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

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

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

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

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

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

Требования

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

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

CM_Get_Child

CM_Get_Device_ID

CM_Get_Device_ID_Size_Ex

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