Compartilhar via


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 Significado
PolicyQualifierTypeUnknown
O tipo de qualificador não é especificado.
PolicyQualifierTypeUrl
O qualificador é uma URL que aponta para uma CPS (Instrução de Prática de Certificação) que foi definida pela autoridade de certificação para descrever as políticas sob as quais o certificado foi emitido e as finalidades para as quais o certificado pode ser usado.
PolicyQualifierTypeUserNotice
O qualificador é uma instrução de texto a ser exibida pelo aplicativo para qualquer usuário que dependa do certificado. O aviso do usuário identifica os usos permitidos do certificado.

Retornar valor

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 possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Código de retorno Descrição
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
O objeto já está inicializado.

Comentários

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 Distinguished Encoding Rules (DER). A URL é codificada como uma cadeia de caracteres IA5 de Notação de Sintaxe Abstrata Um (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) 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 de 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.

Requisitos

Requisito Valor
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
DLL CertEnroll.dll

Confira também

IPolicyQualifier