fonction CM_Get_Version_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_Get_Version_Ex retourne la version 4.0 de la DLL Plug-and-Play (PnP) Configuration Manager (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 une poignée de machine retournée par CM_Connect_Machine.
Valeur retournée
Si la fonction réussit, elle retourne le numéro de révision majeur dans l’octet de commande élevée et le numéro de révision mineur dans l’octet de bas ordre. 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.
Notes
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 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 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 |