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

Статья
08/22/2023

[Начиная с Windows 8 и Windows Server 2012, эта функция устарела и не должна использоваться.]

Функция CM_Get_Version_Ex возвращает версию 4.0 библиотеки DLL-библиотеки Plug and Play (PnP) Configuration Manager (Cfgmgr32.dll) для локального или удаленного компьютера.

Синтаксис

CMAPI WORD CM_Get_Version_Ex(
  [in, optional] HMACHINE hMachine
);

Параметры

[in, optional] hMachine

Предоставляет дескриптор компьютера, возвращаемый CM_Connect_Machine.

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

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

Если функция выполняется успешно, она возвращает номер основной редакции в байте высокого порядка и номер незначительной редакции в байте нижнего порядка. Версия 4.0 возвращается как 0x0400. По умолчанию версия 4.0 поддерживается в Microsoft Windows 2000 и более поздних версиях Windows. При возникновении внутренней ошибки функция возвращает 0x0000. Вызовите Метод GetLastError , чтобы получить код ошибки для сбоя.

Эта функция возвращает версию 4.0 диспетчера конфигураций для обеспечения совместимости с версией 4.0 и всеми более поздними версиями диспетчера конфигураций, а также для обеспечения совместимости со всеми приложениями, которым требуется версия 4.0 диспетчера конфигураций.

Чтобы определить, доступна ли определенная версия диспетчера конфигурации на компьютере, используйте CM_Is_Version_Available или CM_Is_Version_Available_Ex.

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

Требования


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

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

CM_Get_Version

CM_Is_Version_Available

CM_Is_Version_Available_Ex

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