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

O método InitializeEncode inicializa o objeto de uma coleção ICertificatePolicies .

Sintaxe

HRESULT InitializeEncode(
  [in] ICertificatePolicies *pValue
);

Parâmetros

[in] pValue

Ponteiro para a interface ICertificatePolicies .

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.

Valor/código retornado	Descrição
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	O objeto já está inicializado.

Comentários

O método associa a coleção de nomes ao OID (identificador de objeto) XCN_OID_CERT_POLICIES (2.5.29.32) e o codifica usando Distinguished Encoding Rules (DER).

Você deve chamar InitializeEncode ou InitializeDecode antes de usar um objeto IX509ExtensionCertificatePolicies . Os dois métodos se complementam. O método InitializeEncode permite que você construa um objeto de extensão ASN.1 ( Abstract Syntax Notation One ) codificado por DER a partir de dados brutos e o método InitializeDecode permite inicializar os dados brutos de um objeto codificado. Você pode recuperar a coleção de políticas (os dados brutos) chamando a propriedade Policies .

Você pode recuperar as seguintes propriedades para essa extensão:

• A propriedade Critical identifica se a extensão é crítica. Você também pode especificar essa propriedade.
• A propriedade ObjectId recupera o OID da extensão.
• A propriedade Policies recupera a coleção de políticas de certificado (os dados brutos da extensão).

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

IX509ExtensionCertificatePolicies