MÉTHODE IMMCVersionInfo ::GetMMCVersion (mmc.h)

La méthode GetMMCVersion récupère les informations de version de l’application MMC.

Syntaxe

HRESULT GetMMCVersion(
  [out] long *pVersionMajor,
  [out] long *pVersionMinor
);

Paramètres

[out] pVersionMajor

Numéro principal de version. Par exemple, si *pVersionMajor retourne 2, la version 2.x de la console MMC est en cours d’exécution.

[out] pVersionMinor

Numéro secondaire de version. Par exemple, si *pVersionMinor retourne 0, la version X.0 de la console MMC est en cours d’exécution.

Valeur retournée

En cas de réussite, la valeur de retour est S_OK. D’autres valeurs de retour indiquent un code d’erreur.

Remarques

L’interface IMMCVersionInfo est introduite dans MMC 2.0. Pour obtenir des instructions sur la façon de déterminer la version de la console MMC si MMC 1.x est installé, consultez Détection du numéro de version MMC.

Exemples

IMMCVersionInfo * pVersionInfo = NULL;
HRESULT   hr;

// Create an object of the MMCVersionInfo class.
hr = CoCreateInstance(CLSID_MMCVersionInfo,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_IMMCVersionInfo,
                      (void**)&pVersionInfo);
if (S_OK != hr)
{
    // Error encountered.
    // If the system does not support MMCVersionInfo, report it.
    // This would occur if the system was running MMC 1.x.
    if (REGDB_E_CLASSNOTREG == hr)
        OutputDebugString(_T("MMCVersionInfo is not registered\n"));
    else
        // Another error was encountered.
        OutputDebugString(_T("Failed call to CoCreateInstance\n"));
}
else
{
    // Call the GetMMCVersion method.
    long lMajor, lMinor;
    hr = pVersionInfo->GetMMCVersion(&lMajor,
                                     &lMinor);
    if (S_OK != hr)
        OutputDebugString(_T("Failed call to GetMMCVersion\n"));
    else
    {
        OutputDebugString(_T("Success in GetMMCVersion\n"));
        // Use major and minor version information as required.
        // ...
    }
}
// Free the interface pointer.
if (NULL != pVersionInfo)
{
    pVersionInfo->Release();
    pVersionInfo = NULL;
}

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête mmc.h
Bibliothèque Mmc.lib
DLL Mmcndmgr.dll