CM_Get_Version_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_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.
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 |