CM_Get_Version_Ex, fonction (cfgmgr32.h)

  • Article

[À 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_Get_Version_Ex retourne la version 4.0 de la DLL de Configuration Manager Plug-and-Play (PnP) (Cfgmgr32.dll) pour un ordinateur local ou distant.

Syntaxe

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

Paramètres

[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

Si la fonction réussit, elle retourne le numéro de révision principal dans l’octet d’ordre élevé et le numéro de révision secondaire dans l’octet d’ordre inférieur. La version 4.0 est retournée en tant que 0x0400. Par défaut, la version 4.0 est prise en charge par Microsoft Windows 2000 et versions ultérieures de Windows. Si une erreur interne se produit, la fonction retourne 0x0000. Appelez GetLastError pour obtenir le code d’erreur de l’échec.

Remarques

Cette fonction retourne la version 4.0 du gestionnaire de configuration pour garantir la compatibilité avec la version 4.0 et toutes les versions ultérieures du gestionnaire de configuration, et pour garantir la compatibilité avec toutes les applications qui nécessitent la version 4.0 du gestionnaire de configuration.

Pour déterminer si une version spécifique du gestionnaire de configuration est disponible sur un ordinateur, utilisez CM_Is_Version_Available ou CM_Is_Version_Available_Ex.

La fonctionnalité d’accès aux machines distantes a été supprimée dans Windows 8 et Windows Server 2012 et les systèmes d’exploitation ultérieurs. Vous ne pouvez donc pas accéder aux ordinateurs distants lorsque vous exécutez sur ces versions de Windows.

Configuration requise

   
Client minimal pris en charge Disponible dans Microsoft Windows 2000 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_Get_Version

CM_Is_Version_Available

CM_Is_Version_Available_Ex