estrutura CMSG_CTRL_DECRYPT_PARA (wincrypt.h)

  • Artigo

A estrutura CMSG_CTRL_DECRYPT_PARA contém informações usadas para descriptografar uma mensagem em envelope para um destinatário de transporte de chave. Essa estrutura será passada para CryptMsgControl se o parâmetro dwCtrlType for CMSG_CTRL_DECRYPT.

Para obter informações sobre como o CryptoAPI dá suporte à interoperabilidade de email S/MIME ( Secure/Multipurpose Internet Mail Extensions ), consulte a seção Comentários de CryptMsgOpenToEncode.

Sintaxe

typedef struct _CMSG_CTRL_DECRYPT_PARA {
  DWORD cbSize;
  union {
    HCRYPTPROV        hCryptProv;
    NCRYPT_KEY_HANDLE hNCryptKey;
  } DUMMYUNIONNAME;
  DWORD dwKeySpec;
  DWORD dwRecipientIndex;
} CMSG_CTRL_DECRYPT_PARA, *PCMSG_CTRL_DECRYPT_PARA;

Membros

cbSize

O tamanho, em bytes, dessa estrutura.

DUMMYUNIONNAME

DUMMYUNIONNAME.hCryptProv

Identificador CSP (provedor de serviços criptográficos). A função CNG NCryptIsKeyHandle é chamada para determinar a escolha da união.

DUMMYUNIONNAME.hNCryptKey

Um identificador para o CSP ( provedor de serviços criptográficos ) CNG. A função CNG, NCryptIsKeyHandle, é chamada para determinar a escolha da união. Novos algoritmos criptografados só têm suporte em funções CNG. A função CNG, NCryptTranslateHandle, será chamada para converter a opção CryptoAPI hCryptProv quando necessário. Recomendamos que os aplicativos passem, para o membro hNCryptKey , o identificador CSP CNG retornado da função NCryptOpenKey .

dwKeySpec

A chave privada a ser usada. Esse membro não é usado quando o membro hNCryptKey é usado.

Os seguintes valores dwKeySpec são definidos para o provedor padrão.

Valor Significado
AT_KEYEXCHANGE
 Chaves usadas para criptografar e descriptografar chaves de sessão.
AT_SIGNATURE
 Chaves usadas para criar e verificar assinaturas digitais.
 

Se dwKeySpec for zero, o AT_KEYEXCHANGE padrão será usado.

dwRecipientIndex

Índice do destinatário na mensagem associada à chave privada hCryptProv .

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

Confira também

Cryptmsgcontrol