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

Статья
02/26/2024

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

Функция CM_Is_Version_Available_Ex указывает, поддерживается ли указанная версия Plug and Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) локальным или удаленным компьютером.

Синтаксис

CMAPI BOOL CM_Is_Version_Available_Ex(
  [in]           WORD     wVersion,
  [in, optional] HMACHINE hMachine
);

Параметры

[in] wVersion

Определяет версию диспетчера конфигурации. Поддерживаемая версия configuration manager напрямую соответствует версии операционной системы. Основная версия задается байтом высокого порядка, а дополнительная версия — байтом низкого порядка. Например, 0x0400 указывает версию 4.0, которая по умолчанию поддерживается в Microsoft Windows NT 4.0 и более поздних версиях Windows. Версия 0x0501 указывает версию 5.1, которая поддерживается Windows XP и более поздними версиями Windows.

[in, optional] hMachine

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

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

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

Функция возвращает значение TRUE , если функция может подключиться к указанному компьютеру и если компьютер поддерживает указанную версию. В противном случае функция возвращает значение FALSE.

Используйте эту функцию, чтобы определить, поддерживается ли указанная версия диспетчера конфигурации локальным или удаленным компьютером. Если указанная версия поддерживается, компьютер поддерживает все предыдущие версии, включая эту версию. Вы также можете использовать CM_Is_Version_Available , чтобы определить, поддерживает ли локальный компьютер определенную версию диспетчера конфигурации.

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

Требования

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

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

CM_Connect_Machine

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available

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