fonction CM_Is_Version_Available_Ex (cfgmgr32.h)
[En commençant par 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 de commande élevée et la version mineure est spécifiée par l’octet de faible ordre. Par exemple, 0x0400 spécifie la version 4.0, 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, prise en charge par Windows XP et les versions ultérieures de Windows.
[in, optional] hMachine
Fournit une poignée de machine retournée par CM_Connect_Machine.
Valeur retournée
La fonction retourne TRUE si la fonction peut se connecter à l’ordinateur spécifié et si l’ordinateur 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é d’accès aux machines distantes a été supprimée dans Windows 8 et les systèmes d’exploitation Windows Server 2012 et ultérieurs, vous ne pouvez donc pas accéder aux machines distantes lors de l’exécution sur ces versions de Windows.
Configuration requise
| 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 |