Método IPolicyQualifier::InitializeEncode (certenroll.h)

O método InitializeEncode inicializa o objeto de uma cadeia de caracteres e um valor que identifica o tipo de qualificador.

Sintaxe

HRESULT InitializeEncode(
  [in] BSTR                strQualifier,
  [in] PolicyQualifierType Type
);

Parâmetros

[in] strQualifier

Uma variável BSTR que contém o qualificador .

[in] Type

Um valor de enumeração PolicyQualifierType que especifica o tipo de qualificador aplicado a uma política de certificado. Esse pode ser um dos valores a seguir.

Valor de retorno

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

Se você especificar PolicyQualifierTypeUrl no parâmetro Type , esse método associará a cadeia de caracteres inserida no parâmetro strQualifier ao XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) identificador de objeto (OID) e o codifica usando DER (Distinguished Encoding Rules ). A URL é codificada como uma cadeia de caracteres IA5 ( Abstract Syntax Notation One ) (ASN.1).

Se você especificar PolicyQualifierTypeUserNotice no parâmetro Type , esse método associará a cadeia de caracteres inserida no parâmetro strQualifier ao XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2) OID e o codifica usando DER.

Você pode recuperar as seguintes propriedades para este objeto:

• A propriedade ObjectId recupera um OID que identifica se o qualificador é um CPS ou um aviso do usuário.
• A propriedade Qualifier recupera a cadeia de caracteres especificada para o parâmetro strQualifier do método InitializeEncode .
• A propriedade RawData recupera o qualificador codificado em DER.
• A propriedade Type recupera um valor da enumeração PolicyQualifierType que especifica o tipo de qualificador.

Requirements

Consulte também

IPolicyQualifier