Metodo EncryptedData.SetSecret

[CAPICOM è un componente solo a 32 bit disponibile per l'uso nei sistemi operativi seguenti: Windows Server 2008, Windows Vista e Windows XP. Usare invece Platform Calltion Services (PInvoke) per chiamare le funzioni API Win32 CryptEncryptMessage e CryptDecryptMessage per crittografare e decrittografare i messaggi. Per informazioni su PInvoke, vedere Esercitazione su Richiamare la piattaforma. .NET e CryptoAPI tramite P/Invoke: parte 1 e.NET e CryptoAPI tramite P/Invoke: parti 2 sottosezioni di estensione della crittografia .NET con CAPICOM e P/Invoke possono essere utili anche.

Il metodo SetSecret imposta il valore del segreto usato per derivare la chiave di sessione crittografica usata per crittografare e decrittografare i dati.

Sintassi

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

Parametri

newVal [in]

Stringa contenente un segreto usato per creare una chiave crittografica sessione.

SecretType [in, facoltativo]

Valore dell'enumerazione CAPICOM_SECRET_TYPE che indica il tipo di segreto usato per generare la chiave di sessione. Il valore predefinito è CAPICOM_SECRET_PASSWORD. Questo parametro può essere il valore seguente.

Valore Significato
CAPICOM_SECRET_PASSWORD
La chiave di crittografia deve essere derivata da una password.

 

Valore restituito

Questo metodo non restituisce valori.

Commenti

Il segreto viene usato per creare la chiave di sessione per la crittografia o la decrittografia. Lo stesso segreto deve essere usato per entrambe le operazioni. Se il segreto usato per crittografare i dati viene perso, i dati crittografati non possono essere decrittografati.

Se appropriato per l'applicazione, prendere in considerazione l'uso di CryptProtectMemory o CryptProtectData per proteggere il segreto prima e dopo l'uso. Cancellare la memoria associata al segreto al termine.

Requisiti

Requisito Valore
Fine del supporto client
Windows Vista
Fine del supporto server
Windows Server 2008
Componente ridistribuibile
CAPICOM 2.0 o versione successiva in Windows Server 2003 e Windows XP
DLL
Capicom.dll

Vedi anche

Oggetti di crittografia

Encrypteddata