EncryptedData.SetSecret-Methode

[CAPICOM ist eine nur 32-Bit-Komponente, die für die Verwendung in den folgenden Betriebssystemen verfügbar ist: Windows Server 2008, Windows Vista und Windows XP. Verwenden Sie stattdessen Platform Invocation Services (PInvoke), um die Win32-API-Funktionen CryptEncryptMessage und CryptDecryptMessage aufzurufen, um Nachrichten zu verschlüsseln und zu entschlüsseln. Informationen zu PInvoke finden Sie unter Tutorial zum Plattformaufruf. . NET und CryptoAPI über P/Invoke: Teil 1 und .NET und CryptoAPI über P/Invoke: Teil 2 der Erweiterung der .NET-Kryptografie mit CAPICOM und P/Invoke können ebenfalls hilfreich sein.]

Die SetSecret-Methode legt den Wert des Geheimnisses fest, der zum Ableiten des kryptografischen Sitzungsschlüssels zum Verschlüsseln und Entschlüsseln von Daten verwendet wird.

Syntax

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

Parameter

newVal [in]

Eine Zeichenfolge, die ein Geheimnis enthält, das zum Erstellen eines kryptografischen Sitzungsschlüssels verwendet wird.

SecretType [in, optional]

Ein Wert der CAPICOM_SECRET_TYPE Enumeration, der die Art des Geheimnisses angibt, das zum Generieren des Sitzungsschlüssels verwendet wird. Der Standardwert ist CAPICOM_SECRET_PASSWORD. Dieser Parameter kann der folgende Wert sein.

Wert	Bedeutung
CAPICOM_SECRET_PASSWORD	Der Verschlüsselungsschlüssel soll von einem Kennwort abgeleitet werden.

 

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Das Geheimnis wird verwendet, um den Sitzungsschlüssel für die Verschlüsselung oder Entschlüsselung zu erstellen. Für beide Vorgänge muss dasselbe Geheimnis verwendet werden. Wenn das Geheimnis, das zum Verschlüsseln von Daten verwendet wird, verloren geht, können die verschlüsselten Daten nicht entschlüsselt werden.

Falls für Ihre Anwendung geeignet, sollten Sie CryptProtectMemory oder CryptProtectData verwenden, um das Geheimnis vor und nach der Verwendung zu schützen. Löschen Sie den speicher, der dem Geheimnis zugeordnet ist, wenn Sie fertig sind.

Anforderungen

Anforderung	Wert
Ende des Supports (Client)	Windows Vista
Ende des Supports (Server)	WindowsServer 2008
Verteilbare Komponente	CAPICOM 2.0 oder höher unter Windows Server 2003 und Windows XP
DLL	Capicom.dll

Siehe auch

Kryptografieobjekte

Encrypteddata