ICertServerPolicy ::GetCertificateExtensionFlags, méthode (certif.h)

Article
08/22/2023

La méthode GetCertificateExtensionFlags récupère les indicateurs associés à l’extension acquise par l’appel le plus récent à GetCertificateExtension.

Syntaxe

HRESULT GetCertificateExtensionFlags(
  [out] LONG *pExtFlags
);

Paramètres

[out] pExtFlags

Pointeur vers une variable LONG qui contient les indicateurs d’extension.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK et le paramètre pExtFlags contient les indicateurs de l’extension acquise par l’appel le plus récent à GetCertificateExtension.

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 est les indicateurs de l’extension acquise par l’appel le plus récent à GetCertificateExtension.

Remarques

Les méthodes SetContext et GetCertificateExtension doivent être appelées avant GetCertificateExtensionFlags. La méthode SetContext spécifie quelle requête est utilisée comme contexte actuel, et la méthode GetCertificateExtension récupère les extensions de la requête.

Les extensions peuvent contenir des indicateurs de stratégie et d’origine. Les indicateurs de stratégie fournissent des informations sur l’extension de certificat. Les indicateurs de stratégie peuvent être définis par le module de stratégie. Les indicateurs d’origine indiquent le module qui définit l’extension de certificat. Les indicateurs d’origine 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.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. Pour plus d’informations, consultez ICertAdmin ::SetCertificateExtension.
EXTENSION_ORIGIN_SERVER	Le moteur de serveur a défini 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é transmis à 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.14) ou szOID_RSA_certExtensions (1.2.840.113549.1.9.14) d’une requête PKCS #7.

Des 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.

Il est sûr d’utiliser les 8 bits élevés de EXTENSION_POLICY_MASK pour les données personnalisées. Ces bits seront enregistrés de manière permanente dans la base de données, mais ne seront pas écrits dans les extensions de certificat.

Exemples

HRESULT  hr;
LONG     ExtFlags;
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->GetCertificateExtensionFlags( &ExtFlags);

// More than one policy flag might be set.
LONG ExtPolicyFlags = ExtFlags & EXTENSION_POLICY_MASK;

if (ExtPolicyFlags & EXTENSION_CRITICAL_FLAG)
{
    // Do something.
}

if (ExtPolicyFlags & EXTENSION_DISABLE_FLAG)
{
    // Do something.
}

// only one origin flag can be set
switch (ExtFlags & EXTENSION_ORIGIN_MASK)
{
    case EXTENSION_ORIGIN_REQUEST:
        // Extension was set in certificate request.
        break;
    case EXTENSION_ORIGIN_POLICY:
        // Extension was set by policy module.
        break;
    case EXTENSION_ORIGIN_ADMIN:
        // Extension was set by administrator.
        break;
    case EXTENSION_ORIGIN_SERVER:
        // Extension was set by server engine.
        break;
    default:
        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	certif.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certcli.dll