функция CM_Get_Device_ID_Size_Ex (cfgmgr32.h)
[Начиная с Windows 8 и Windows Server 2012 эта функция устарела. Вместо этого используйте CM_Get_Device_ID_Size .]
Функция CM_Get_Device_ID_Size_Ex извлекает размер буфера, необходимый для хранения идентификатора экземпляра устройства на локальном или удаленном компьютере.
Синтаксис
CMAPI CONFIGRET CM_Get_Device_ID_Size_Ex(
[out] PULONG pulLen,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Параметры
[out] pulLen
Получает значение, представляющее требуемый размер буфера в символах.
[in] dnDevInst
Дескриптор экземпляра устройства, предоставленный вызывающим абонентом, привязанный к локальному компьютеру.
[in] ulFlags
Не используется, должно быть равно нулю.
[in, optional] hMachine
Дескриптор компьютера, предоставленный вызывающим абонентом, к которому привязан дескриптор экземпляра устройства, предоставленный вызывающим абонентом.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с префиксом CR_, определенных в Cfgmgr32.h.
Комментарии
Для определения размера буфера, требуемого для CM_Get_Device_ID_Ex, необходимо вызвать функцию CM_Get_Device_ID_Size_Ex.
Значение размера, указанное в расположении, на которое указывает pulLen , меньше MAX_DEVICE_ID_LEN и не включает завершающее значение NULL строки идентификатора. Если указанный экземпляр устройства не существует, функция предоставляет нулевое значение размера.
Сведения об идентификаторах экземпляров устройств см. в разделе Строки идентификации устройств.
Сведения об использовании дескрипторов экземпляров устройства, привязанных к локальному или удаленному компьютеру, см. в разделе CM_Get_Child_Ex.
Функциональные возможности доступа к удаленным компьютерам были удалены в операционных системах Windows 8 и Windows Server 2012 и более поздних версий, поэтому вы не сможете получить доступ к удаленным компьютерам при работе в этих версиях Windows.
Требования
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
| Библиотека | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |