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

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

Encrypteddata