Interface IPolicyQualifier (certenroll.h)
A interface IPolicyQualifier representa um qualificador que pode ser associado a uma política de certificado. A sintaxe a seguir mostra as estruturas ASN.1 ( Abstract Syntax Notation One ) que definem políticas de certificado e seus qualificadores associados. O valor é codificado usando Distinguished Encoding Rules (DER) e incluído na solicitação de certificado com o objeto de política que ele qualifica.
----------------------------------------------------------------------
-- CertificatePolicies
-- XCN_OID_CERT_POLICIES (2.5.29.32)
----------------------------------------------------------------------
CertificatePolicies ::= SEQUENCE OF PolicyInformation
PolicyInformation ::= SEQUENCE
{
policyIdentifier EncodedObjectID,
policyQualifiers PolicyQualifiers OPTIONAL
}
PolicyQualifiers ::= SEQUENCE OF PolicyQualifierInfo
PolicyQualifierInfo ::= SEQUENCE
{
policyQualifierId EncodedObjectID,
qualifier NOCOPYANY OPTIONAL
}
----------------------------------------------------------------------
-- UserNotice
-- XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2)
----------------------------------------------------------------------
UserNotice ::= SEQUENCE
{
noticeRef, -- Not supported
explicitText -- Not supported
}
----------------------------------------------------------------------
-- Certification Practice Statement (CPS) qualifier
-- XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1)
----------------------------------------------------------------------
CpsURLs ::= SEQUENCE OF SEQUENCE
{
url IA5String,
digestAlgorithmId, -- Not supported
digest -- Not supported
}
Os qualificadores de política podem ser usados quando um OID (identificador de objeto ) é considerado insuficiente para identificar totalmente uma política. Os qualificadores são definidos usando a interface IPolicyQualifier e podem ser associados a uma política adicionando qualificadores à coleção IPolicyQualifiers recuperada de um objeto ICertificatePolicy . Uma autoridade de certificação do Windows dá suporte aos qualificadores a seguir.
| Valor | Descrição |
|---|---|
| XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE(1.3.6.1.5.5.7.2.2) | Contém um aviso a ser exibido para qualquer usuário que depende do certificado. |
| XCN_OID_PKIX_POLICY_QUALIFIER_CPS(1.3.6.1.5.5.7.2.1) | Identifica um ponteiro para um URI que contém a CPS (Instrução de Prática de Certificação) definida pela autoridade de certificação. |
A menos que um usuário observe que a cadeia duplica outra, todos os avisos no caminho do certificado devem ser exibidos para a terceira parte confiável. Para minimizar a duplicação, esse qualificador deve estar presente apenas nos certificados de autoridade de certificação e certificados de entidade final emitidos para outras organizações. O aviso do usuário tem dois campos opcionais, noticeRef e explicitText, que não têm suporte. Políticas e qualificadores de política são usados em objetos IX509ExtensionCertificatePolicies .
Herança
A interface IPolicyQualifier herda da interface IDispatch . IPolicyQualifier também tem esses tipos de membros:
Métodos
A interface IPolicyQualifier tem esses métodos.
| IPolicyQualifier::get_ObjectId Recupera o OID (identificador de objeto) para o qualificador. |
| IPolicyQualifier::get_Qualifier Recupera uma cadeia de caracteres que contém o qualificador usado para inicializar o objeto. |
| IPolicyQualifier::get_RawData Recupera o objeto qualificador codificado em DISTINGUISHED ENCODING RULES (DER). |
| IPolicyQualifier::get_Type Recupera o tipo de qualificador. |
| IPolicyQualifier::InitializeEncode Inicializa o objeto de uma cadeia de caracteres e um valor que identifica o tipo de qualificador. |
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | certenroll.h |