Partager via

Méthode IEnumCERTVIEWEXTENSION ::GetFlags (certview.h)

  • Article

La méthode GetFlags récupère les indicateurs de stratégie et d’origine de l’extension actuelle dans la séquence extension-énumération.

Les indicateurs de stratégie et d’origine sont retournés dans une variable, et des masques de bits sont fournis pour récupérer les valeurs individuelles.

Syntaxe

HRESULT GetFlags(
  [out] LONG *pFlags
);

Paramètres

[out] pFlags

Pointeur vers un type LONG qui contient les indicateurs de stratégie et d’origine de l’extension. Cette méthode échoue si le paramètre pFlags a la valeur NULL.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

La valeur de retour représente les valeurs de stratégie et d’origine de l’extension.

Remarques

Cette méthode est utilisée pour récupérer les indicateurs de stratégie et d’origine de l’extension actuellement référencée par la séquence d’énumération d’extension.

Les indicateurs de stratégie fournissent des informations sur l’extension de certificat et peuvent être définis par le module de stratégie.

Les indicateurs d’origine indiquent le module qui définit l’extension de certificat et sont définis uniquement par le moteur de serveur.

Un ou plusieurs indicateurs de stratégie peuvent être retournés à partir d’une extension. Voici des indicateurs de stratégie prédéfinis.

Valeur de l’indicateur de stratégie Explication
EXTENSION_CRITICAL_FLAG Il s’agit d’une extension critique.
EXTENSION_DISABLE_FLAG L’extension ne sera pas utilisée.
 

L’un des indicateurs d’origine suivants peut également être retourné.

Valeur de l’indicateur d’origine Explication
EXTENSION_ORIGIN_REQUEST L’extension a été extraite d’un tableau d’extensions stocké dans l’attribut szOID_CERT_EXTENSIONS (1.3.6.1.4.1.311.2.1.14) ou szOID_RSA_certExtensions (1.2.840.113549.1.9.14) d’une requête PKCS #10.
EXTENSION_ORIGIN_POLICY Le module de stratégie définit l’extension.
EXTENSION_ORIGIN_ADMIN L’administrateur a défini l’extension.
EXTENSION_ORIGIN_SERVER Le moteur de serveur définit l’extension.
EXTENSION_ORIGIN_RENEWALCERT L’extension a été extraite du certificat stocké dans l’attribut szOID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1) d’une demande de renouvellement PKCS #10.
EXTENSION_ORIGIN_IMPORTEDCERT L’extension a été extraite d’un certificat importé (le certificat a été passé à ICertAdmin ::ImportCertificate).
EXTENSION_ORIGIN_PKCS7 L’extension a été extraite d’un tableau d’extensions stocké dans l’attribut szOID_CERT_EXTENSIONS (1.3.6.1.4.1.311.2.1.14) ou szOID_RSA_certExtensions (1.2.840.113549.1.9.14) d’une requête PKCS #7.
 

Les masques prédéfinis sont fournis pour faciliter l’utilisation des indicateurs définis dans la valeur de retour. Les masques suivants sont fournis.

Valeur du masque Explication
EXTENSION_POLICY_MASK Cette valeur (0x0000FFFF) est utilisée pour examiner les indicateurs de stratégie.
EXTENSION_ORIGIN_MASK Cette valeur (0x000F0000) est utilisée pour examiner les indicateurs d’origine.
 

Si la séquence d’énumération d’extension ne fait pas référence à une extension valide, GetFlags échoue. Utilisez l’une des méthodes suivantes pour parcourir l’énumération :

Exemples

HRESULT  hr;
LONG     ExtFlags;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->GetFlags(&ExtFlags);
if (S_OK != hr)
    printf("Failed GetFlags - %x\n", hr);
else
{
    LONG ExtPol, ExtOrig;

    ExtPol = ExtFlags & EXTENSION_POLICY_MASK;
    if (ExtPol & EXTENSION_CRITICAL_FLAG)
        printf("The extension is critical\n");
    if (ExtPol & EXTENSION_DISABLE_FLAG )
        printf("The extension is disabled\n");

    ExtOrig = ExtFlags & EXTENSION_ORIGIN_MASK;
    switch (ExtOrig)
    {
        case EXTENSION_ORIGIN_REQUEST:
            printf("Extension originated by PKCS #10 Request\n");
            break;
        case EXTENSION_ORIGIN_POLICY:
            printf("Extension originated by Policy\n");
            break;
        case EXTENSION_ORIGIN_ADMIN:
            printf("Extension originated by Admin\n");
            break;
        case EXTENSION_ORIGIN_SERVER:
            printf("Extension originated by Server\n");
            break;
        case EXTENSION_ORIGIN_RENEWALCERT:
            printf("Extension originated by Renewal Request\n");
            break;
        case EXTENSION_ORIGIN_IMPORTEDCERT:
            printf("Extension originated by an imported "
                "certificate\n");
            break;
        case EXTENSION_ORIGIN_PKCS7:
            printf("Extension originated by PKCS #7 Request\n");
            break;
        default:
            printf("Unknown extension origin\n");
            break;
    }
}

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête certview.h (inclure Certsrv.h)
Bibliothèque Certidl.lib
DLL Certadm.dll

Voir aussi

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWEXTENSION ::GetName

IEnumCERTVIEWEXTENSION ::GetValue

IEnumCERTVIEWEXTENSION ::Next