DecryptMessage (Negotiate) 関数

DecryptMessage (Negotiate) 関数は、メッセージの暗号化を解除します。 一部のパッケージでは、メッセージを暗号化および暗号化解除するのではなく、整合性ハッシュを実行してチェックします。

構文

SECURITY_STATUS SEC_Entry DecryptMessage(
  _In_    PCtxtHandle    phContext,
  _Inout_ PSecBufferDesc pMessage,
  _In_    ULONG          MessageSeqNo,
  _Out_   PULONG         pfQOP
);

パラメーター

phContext [in]

メッセージの暗号化を解除するために使用される セキュリティ コンテキスト へのハンドル。

pMessage [in, out]

SecBufferDesc 構造体へのポインター。 入力時に、構造体は 1 つ以上 の SecBuffer 構造体を参照します。 これらの少なくとも 1 つは、SECBUFFER_DATA型である必要があります。 そのバッファーには、暗号化されたメッセージが含まれています。 暗号化されたメッセージは暗号化解除され、バッファーの元の内容が上書きされます。

MessageSeqNo [in]

トランスポート アプリケーションで予期されるシーケンス番号 (存在する場合)。 トランスポート アプリケーションでシーケンス番号が保持されない場合は、このパラメーターを 0 に設定する必要があります。

pfQOP [out]

保護の品質を示すパッケージ固有のフラグを受け取る ULONG 型の変数へのポインター。

このパラメーターには、次のフラグを指定できます。

戻り値

関数がメッセージが正しいシーケンスで受信されたことを確認すると、関数は SEC_E_OKを返します。

関数がメッセージの暗号化解除に失敗すると、次のいずれかのエラー コードが返されます。

解説

アプリケーションがリモート パーティからデータを読み取り、 DecryptMessage (Negotiate) を使用して復号化を試み、 DecryptMessage (Negotiate) が成功したが出力バッファーが空であることを検出することがあります。 これは通常の動作であり、アプリケーションはそれに対処できる必要があります。

Windows XP: この関数は UnsealMessage とも呼ばれていました。 アプリケーションでは DecryptMessage (ネゴシエート) のみを使用する必要があります。

必要条件

関連項目

• SSPI 関数
• EncryptMessage (ネゴシエート)
• SecBuffer
• SecBufferDesc