Função CryptMsgEncodeAndSignCTL (wincrypt.h)

Artigo
08/27/2023

A função CryptMsgEncodeAndSignCTL codifica uma CTL e cria uma mensagem assinada que contém a CTL codificada.

Essa função codifica primeiro a CTL apontada por pCtlInfo e, em seguida, chama CryptMsgSignCTL para assinar a mensagem codificada.

Sintaxe

BOOL CryptMsgEncodeAndSignCTL(
  [in]      DWORD                    dwMsgEncodingType,
  [in]      PCTL_INFO                pCtlInfo,
  [in]      PCMSG_SIGNED_ENCODE_INFO pSignInfo,
  [in]      DWORD                    dwFlags,
  [out]     BYTE                     *pbEncoded,
  [in, out] DWORD                    *pcbEncoded
);

Parâmetros

[in] dwMsgEncodingType

Especifica o tipo de codificação usado. É sempre aceitável especificar os tipos de codificação de certificado e mensagem combinando-os com uma operação OR bit a bit, conforme mostrado no exemplo a seguir:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Os tipos de codificação definidos no momento são:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pCtlInfo

Um ponteiro para a estrutura CTL_INFO que contém a CTL a ser codificada e assinada.

[in] pSignInfo

Um ponteiro para uma estrutura CMSG_SIGNED_ENCODE_INFO que contém uma matriz de estruturas de CMSG_SIGNER_ENCODE_INFO .

A mensagem poderá ser codificada sem signatários se o membro cbSize da estrutura estiver definido como o tamanho da estrutura e todos os outros membros forem definidos como zero.

[in] dwFlags

CMSG_ENCODE_SORTED_CTL_FLAG será definido se as entradas CTL devem ser classificadas antes da codificação. Esse sinalizador será definido se as funções CertFindSubjectInSortedCTL ou CertEnumSubjectInSortedCTL forem chamadas.

CMSG_ENCODE_HASHED_SUBJECT_IDENTIFIER_FLAG será definido se CMSG_ENCODE_SORTED_CTL_FLAG estiver definido e o identificador para TrustedSubjects for um hash, como MD5 ou SHA1.

Se CMS_PKCS7 for definido, dwFlags poderá ser definido como CMSG_CMS_ENCAPSULATED_CTL_FLAG para codificar uma mensagem V3 SignedData compatível com CMS.

[out] pbEncoded

Um ponteiro para um buffer que recebe a mensagem codificada e assinada criada.

Esse parâmetro pode ser NULL para definir o tamanho dessas informações para fins de alocação de memória. Para obter mais informações, consulte Recuperando dados de comprimento desconhecido.

[in, out] pcbEncoded

Um ponteiro para um DWORD que especifica o tamanho, em bytes, do buffer pbEncoded . Quando a função retorna, o DWORD contém o número de bytes armazenados ou a serem armazenados no buffer.

Retornar valor

Se a função for bem-sucedida, o valor retornado será diferente de zero (TRUE).

Se a função falhar, o valor retornado será zero (FALSE). Para obter informações de erro estendidas, chame GetLastError. Erros podem ser propagados de chamadas para CryptMsgOpenToEncode e CryptMsgUpdate.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll