estrutura CTL_CONTEXT (wincrypt.h)

Artigo
03/15/2023

A estrutura CTL_CONTEXT contém as representações codificadas e decodificadas de uma CTL. Ele também contém um identificador HCRYPTMSG aberto para a mensagem assinada criptograficamente decodificada que contém o CTL_INFO como seu conteúdo interno.

As funções de mensagem de baixo nível cryptoAPI podem ser usadas para extrair informações adicionais do signatário.

Uma CTL_CONTEXT retornada por qualquer função CryptoAPI deve ser liberada chamando a função CertFreeCTLContext .

Sintaxe

typedef struct _CTL_CONTEXT {
  DWORD      dwMsgAndCertEncodingType;
  BYTE       *pbCtlEncoded;
  DWORD      cbCtlEncoded;
  PCTL_INFO  pCtlInfo;
  HCERTSTORE hCertStore;
  HCRYPTMSG  hCryptMsg;
  BYTE       *pbCtlContent;
  DWORD      cbCtlContent;
} CTL_CONTEXT, *PCTL_CONTEXT;

Membros

dwMsgAndCertEncodingType

Tipo de codificação usada. É 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

pbCtlEncoded

Um ponteiro para a CTL codificada.

cbCtlEncoded

O tamanho, em bytes, da CTL codificada.

pCtlInfo

Um ponteiro para CTL_INFO estrutura contém as informações de CTL.

hCertStore

Um identificador para o repositório de certificados.

hCryptMsg

Abra o identificador HCRYPTMSG para uma mensagem decodificada e assinada por criptografia que contém o CTL_INFO como seu conteúdo interno.

pbCtlContent

O conteúdo interno codificado da mensagem assinada.

cbCtlContent

Contagem, em bytes, de pbCtlContent.

Requisitos


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]
Cabeçalho	wincrypt.h