Método ISmimeCapability::Initialize (certenroll.h)

  • Artigo

O método Initialize inicializa o objeto de um OID ( identificador de objeto de algoritmo de criptografia simétrica) e um comprimento de chave opcional.

Sintaxe

HRESULT Initialize(
  [in] IObjectId *pObjectId,
  [in] LONG      BitCount
);

Parâmetros

[in] pObjectId

Ponteiro para uma interface IObjectId que representa o OID.

[in] BitCount

Uma variável LONG que contém o comprimento do bit da chave simétrica.

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
CERTSRV_E_PROPERTY_EMPTY
 O ponteiro IObjectId é NULL.

Comentários

Os seguintes algoritmos de criptografia simétrica são compatíveis com a API de Registro de Certificado. Somente os algoritmos RC2 e RC4 têm comprimentos de chave variáveis que podem ser especificados.

OID Comprimento da chave Descrição
XCN_OID_OIWSEC_desCBC1.3.14.3.2.7 56 O tamanho da chave é do algoritmo DES CBC de 56 bits. Você não precisa especificar esse valor.
XCN_OID_RSA_DES_EDE3_CBC1.2.840.113549.3.7 168 O tamanho da chave é do algoritmo CBC 3DES é de 168 bits. Você não precisa especificar esse valor.
XCN_OID_RSA_RC2CBC1.2.840.113549.3.2 40 a 128 RC4 é um algoritmo de chave variável. os valores comuns são 40, 64 e 128 bits.
XCN_OID_RSA_RC41.2.840.113549.3.4 40 a 128 RC4 é um algoritmo de chave variável. os valores comuns são 40, 64 e 128 bits.
XCN_OID_RSA_SMIMEalgCMS3DESwrap1.2.840.113549.1.9.16.3.6 168 O tamanho da chave do algoritmo de encapsulamento de chave DES (MMS Data Encryption Standard ) é de 168 bits. Você não precisa especificar esse valor.
XCN_OID_RSA_SMIMEalgCMSRC2wrap1.2.840.113549.1.9.16.3.7 128 O tamanho da chave do algoritmo de encapsulamento de chave MMS RC2 é de 128 bits. Você não precisa especificar esse valor.
XCN_OID_NIST_AES128_CBC2.16.840.1.101.3.4.1.2 128 O tamanho da chave é implícito pelo OID. Você não precisa especificar esse valor.
XCN_OID_NIST_AES192_CBC2.16.840.1.101.3.4.1.22 192 O tamanho da chave é implícito pelo OID. Você não precisa especificar esse valor.
XCN_OID_NIST_AES256_CBC2.16.840.1.101.3.4.1.42 256 O tamanho da chave é implícito pelo OID. Você não precisa especificar esse valor.
XCN_OID_NIST_AES128_WRAP2.16.840.1.101.3.4.1.5 128 O tamanho da chave é implícito pelo OID. Você não precisa especificar esse valor.
XCN_OID_NIST_AES192_WRAP2.16.840.1.101.3.4.1.25 192 O tamanho da chave é implícito pelo OID. Você não precisa especificar esse valor.
XCN_OID_NIST_AES256_WRAP2.16.840.1.101.3.4.1.45 256 O tamanho da chave é implícito pelo OID. Você não precisa especificar esse valor.
 

O comprimento da chave que você especifica para algoritmos RC2 e RC4 deve ser consistente com o compatível com o provedor criptográfico ou provedores usados pelo cliente. Para obter mais informações, consulte ICspInformation. Você pode recuperar o comprimento do bit chamando a propriedade BitCount e pode recuperar o algoritmo OID chamando a propriedade ObjectId .

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

ISmimeCapabilities

ISmimeCapability

IX509ExtensionSmimeCapabilities