estructura CTL_CONTEXT (wincrypt.h)

Artículo
03/15/2023

La estructura CTL_CONTEXT contiene las representaciones codificadas y descodificadas de un CTL. También contiene un identificador HCRYPTMSG abierto para el mensaje descodificado y firmado criptográficamente que contiene el CTL_INFO como su contenido interno.

Las funciones de mensaje de bajo nivel cryptoAPI se pueden usar para extraer información adicional del firmante.

Una CTL_CONTEXT devuelta por cualquier función CryptoAPI debe liberarse llamando a la función CertFreeCTLContext .

Sintaxis

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;

Miembros

dwMsgAndCertEncodingType

Tipo de codificación usada. Siempre es aceptable especificar los tipos de codificación de certificados y mensajes al combinarlos con una operación OR bit a bit, como se muestra en el ejemplo siguiente:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Los tipos de codificación definidos actualmente son:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

pbCtlEncoded

Puntero al CTL codificado.

cbCtlEncoded

Tamaño, en bytes, del CTL codificado.

pCtlInfo

Un puntero a CTL_INFO estructura contiene la información de CTL.

hCertStore

Identificador del almacén de certificados.

hCryptMsg

Abra el identificador HCRYPTMSG en un mensaje con firma criptográfica descodificada que contenga el CTL_INFO como contenido interno.

pbCtlContent

Contenido interno codificado del mensaje firmado.

cbCtlContent

Recuento, en bytes, de pbCtlContent.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	wincrypt.h