Função CertCreateCTLContext (wincrypt.h)
A função CertCreateCTLContext cria um contexto ctl de uma CTL codificada. O contexto criado não é persistido em um repositório de certificados. A função faz uma cópia da CTL codificada dentro do contexto criado.
Sintaxe
PCCTL_CONTEXT CertCreateCTLContext(
[in] DWORD dwMsgAndCertEncodingType,
[in] const BYTE *pbCtlEncoded,
[in] DWORD cbCtlEncoded
);
Parâmetros
[in] dwMsgAndCertEncodingType
Especifica o tipo de codificação usado. Os tipos de codificação de certificado e mensagem devem ser especificados combinando-os com uma operação OR bit a bit, conforme mostrado no exemplo a seguir:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Tipos de codificação definidos atualmente são:
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
[in] pbCtlEncoded
Um ponteiro para um buffer que contém a CTL codificada da qual o contexto deve ser criado.
[in] cbCtlEncoded
O tamanho, em bytes, do buffer pbCtlEncoded .
Retornar valor
Se a função for bem-sucedida, o valor retornado será um ponteiro para um CTL_CONTEXT somente leitura.
Se a função falhar e não conseguir decodificar e criar o CTL_CONTEXT, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError. A tabela a seguir mostra um possível código de erro.
| Código de retorno | Descrição |
|---|---|
|
Tipo de codificação de certificado inválido. Há suporte apenas para PKCS_7_ASN_ENCODING e X509_ASN_ENCODING. |
Se a função falhar, GetLastError poderá retornar um erro de codificação/decodificação ASN.1 ( Abstract Syntax Notation One ). Para obter informações sobre esses erros, consulte Valores retornados de codificação/decodificação asn.1.
Comentários
O CTL_CONTEXT deve ser liberado chamando CertFreeCTLContext. CertDuplicateCTLContext pode ser chamado para tornar uma duplicata. CertSetCTLContextProperty e CertGetCTLContextProperty podem ser chamados para armazenar e ler propriedades para a CTL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | wincrypt.h |
| Biblioteca | Crypt32.lib |
| DLL | Crypt32.dll |