функция CM_Get_Device_ID_Size (cfgmgr32.h)
Функция 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.
Комментарии
Для определения размера буфера, требуемого для CM_Get_Device_ID, необходимо вызвать функцию CM_Get_Device_ID_Size.
Значение размера, указанное в расположении, на которое указывает 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 |