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

Article
02/29/2024

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

Partager via