Compartilhar via


Método EnvelopedData.Encrypt

[CAPICOM é um componente somente de 32 bits que está disponível para uso nos seguintes sistemas operacionais: Windows Server 2008, Windows Vista e Windows XP. Em vez disso, use a classe EnvelopedCms no namespace System.Security.Cryptography.Pkcs .]

O método Encrypt gera uma chave de sessão, usa essa chave para criptografar o conteúdo, envolve o conteúdo criptografado para cada destinatário criptografando a chave de sessão com a chave pública de cada destinatário e retorna o BLOB que contém o conteúdo criptografado e as chaves de sessão criptografadas como uma cadeia de caracteres codificada.

Sintaxe

EnvelopedData.Encrypt( _
  [ ByVal EncodingType ] _
)

Parâmetros

EncodingType [in, opcional]

Um valor da enumeração CAPICOM_ENCODING_TYPE que indica o tipo de codificação usado para codificar os dados enveloped. O valor de codificação padrão é CAPICOM_ENCODE_BASE64. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
CAPICOM_ENCODE_ANY
Esse tipo de codificação é usado somente quando os dados de entrada têm um tipo de codificação desconhecido. Se esse valor for usado para especificar o tipo de codificação da saída, CAPICOM_ENCODE_BASE64 será usado. Introduzido no CAPICOM 2.0.
CAPICOM_ENCODE_BASE64
Os dados são salvos como uma cadeia de caracteres codificada em base64.
CAPICOM_ENCODE_BINARY
Os dados são salvos como uma sequência binária pura.

 

Valor retornado

Esse método retorna um BLOB que contém os dados envolvidos em uma cadeia de caracteres codificada.

Comentários

O BLOB retornado contém o conteúdo criptografado e uma chave de sessão criptografada para cada destinatário pretendido. Essas chaves de sessão são criptografadas usando a chave pública de cada destinatário. As chaves de sessão criptografadas só podem ser descriptografadas com a chave privada de um destinatário.

Se a propriedade Recipients não contiver nenhuma informação, esse método pesquisa o repositório de certificados AddressBook do usuário atual em busca de destinatários potenciais. Se mais de um destinatário potencial for encontrado, o usuário será solicitado a selecionar um destinatário em uma caixa de diálogo de seleção.

Requisitos

Requisito Valor
Fim do suporte ao cliente
Windows Vista
Fim do suporte ao servidor
Windows Server 2008
Redistribuível
CAPICOM 2.0 ou posterior no Windows Server 2003 e Windows XP
DLL
Capicom.dll

Confira também

Objetos de criptografia

EnvelopedData