CM_Is_Version_Available_Ex, fonction (cfgmgr32.h)
[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée et ne doit pas être utilisée.]
La fonction CM_Is_Version_Available_Ex indique si une version spécifiée du Plug-and-Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) est prise en charge par un ordinateur local ou distant.
Syntaxe
CMAPI BOOL CM_Is_Version_Available_Ex(
[in] WORD wVersion,
[in, optional] HMACHINE hMachine
);
Paramètres
[in] wVersion
Identifie une version du gestionnaire de configuration. La version prise en charge du gestionnaire de configuration correspond directement à la version du système d’exploitation. La version principale est spécifiée par l’octet d’ordre élevé et la version secondaire est spécifiée par l’octet de bas ordre. Par exemple, 0x0400 spécifie la version 4.0, qui est prise en charge par défaut par Microsoft Windows NT 4.0 et versions ultérieures de Windows. La version 0x0501 spécifie la version 5.1, qui est prise en charge par Windows XP et les versions ultérieures de Windows.
[in, optional] hMachine
Fournit un handle de machine retourné par CM_Connect_Machine.
Valeur retournée
La fonction retourne TRUE si la fonction peut se connecter à l’ordinateur spécifié et si la machine prend en charge la version spécifiée. Sinon, la fonction retourne FALSE.
Remarques
Utilisez cette fonction pour déterminer si une version spécifiée du gestionnaire de configuration est prise en charge par un ordinateur local ou distant. Si la version spécifiée est prise en charge, toutes les versions antérieures et y compris cette version sont prises en charge par l’ordinateur. Vous pouvez également utiliser CM_Is_Version_Available pour déterminer si l’ordinateur local prend en charge une version spécifique du gestionnaire de configuration.
La fonctionnalité permettant d’accéder aux ordinateurs distants a été supprimée dans Windows 8 et Windows Server 2012 systèmes d’exploitation et versions ultérieures. Vous ne pouvez donc pas accéder aux ordinateurs distants lors de l’exécution sur ces versions de Windows.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows XP et versions ultérieures de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | cfgmgr32.h (inclure Cfgmgr32.h) |
| Bibliothèque | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |