Método ISmimeCapability::Initialize (certenroll.h)
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 |
|---|---|
|
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 |