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

Статья
08/22/2023

[Начиная с 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

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

Примечание Использование этой функции для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.

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

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

Значение размера, указанное в расположении, на которое указывает 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

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

CM_Get_Child_Ex

CM_Get_Device_ID_Ex

CM_Get_Device_ID_Size

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