Partager via


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.

Note L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.
 

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

Voir aussi

CM_Connect_Machine

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available