Método EncryptedData.SetSecret

[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 os Serviços de Invocação de Plataforma (PInvoke) para chamar as funções da API win32 CryptEncryptMessage e CryptDecryptMessage para criptografar e descriptografar mensagens. Para obter informações sobre o PInvoke, consulte Tutorial de invocação de plataforma. As subseções .NET e CryptoAPI via P/Invoke: Parte 1 e .NET e CryptoAPI por meio de P/Invoke: Subseções da Parte 2 da Extensão da Criptografia do .NET com CAPICOM e P/Invoke também podem ser úteis.]

O método SetSecret define o valor do segredo usado para derivar a chave de sessão criptográfica usada para criptografar e descriptografar dados.

Sintaxe

EncryptedData.SetSecret( _
  ByVal newVal, _
  [ ByVal SecretType ] _
)

Parâmetros

newVal [in]

Uma cadeia de caracteres que contém um segredo usado para criar uma chave criptográfica de sessão.

SecretType [in, opcional]

Um valor da enumeração CAPICOM_SECRET_TYPE que indica o tipo de segredo usado para gerar a chave de sessão. O valor padrão é CAPICOM_SECRET_PASSWORD. Esse parâmetro pode ser o valor a seguir.

Valor	Significado
CAPICOM_SECRET_PASSWORD	A chave de criptografia deve ser derivada de uma senha.

 

Valor retornado

Esse método não retorna um valor.

Comentários

O segredo é usado para criar a chave de sessão para criptografia ou descriptografia. O mesmo segredo deve ser usado para ambas as operações. Se o segredo usado para criptografar dados for perdido, os dados criptografados não poderão ser descriptografados.

Se apropriado para seu aplicativo, considere usar CryptProtectMemory ou CryptProtectData para proteger o segredo antes e depois do uso. Limpe a memória associada ao segredo quando terminar.

Requisitos

Confira também

Objetos de criptografia

Encrypteddata