EncryptedData.SetSecret メソッド

[CAPICOM は、Windows Server 2008、Windows Vista、および Windows XP のオペレーティングシステムで使用できる 32 ビットのみのコンポーネントです。代わりに、プラットフォーム呼び出しサービス (PInvoke) を使用して Win32 API 関数 CryptEncryptMessage と CryptDecryptMessage を呼び出してメッセージを暗号化および復号化します。 PInvoke の詳細については、「プラットフォーム呼び出しのチュートリアル」を参照してください。 P/Invoke を介した .NET と CryptoAPI: パート 1 と P/Invoke による .NET と CryptoAPI:CAPICOM と P/Invoke による .NET 暗号化の拡張のパート 2 サブセクションも役立つ場合があります。

SetSecret メソッドは、データの暗号化と暗号化解除に使用される暗号化セッションキーの派生に使用されるシークレットの値を設定します。

構文

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

newVal [in]

セッション暗号化キーの作成に使用されるシークレットを含む文字列。

SecretType [in, optional]

セッションキーの生成に使用されるシークレットの種類を示す CAPICOM_SECRET_TYPE 列挙の値。既定値は CAPICOM_SECRET_PASSWORD です。このパラメーターには、次の値を指定できます。

値	説明
CAPICOM_SECRET_PASSWORD	暗号化キーは、パスワードから派生します。

このメソッドは値を返しません。

シークレットは、暗号化または暗号化解除のためのセッションキーを作成するために使用されます。両方の操作に同じシークレットを使用する必要があります。データの暗号化に使用されるシークレットが失われた場合、暗号化されたデータを暗号化解除することはできません。

アプリケーションに適している場合は、 CryptProtectMemory または CryptProtectData を使用して、使用の前後にシークレットを保護することを検討してください。完了したら、シークレットに関連付けられているメモリをクリアします。

要件	値
クライアントサポートの終了	Windows Vista
サーバーサポートの終了	Windows Server 2008
再頒布可能パッケージ	Windows Server 2003 および Windows XP の CAPICOM 2.0 以降
[DLL]	Capicom.dll