EncryptMessage (NTLM) 関数

EncryptMessage (NTLM) 関数は、メッセージを暗号化してプライバシーを提供します。 EncryptMessage (NTLM) を使用すると、選択したメカニズムでサポートされている 暗号化アルゴリズム の中からアプリケーションを選択できます。 EncryptMessage (NTLM) 関数は、コンテキスト ハンドルによって参照されるセキュリティ コンテキストを使用します。 一部のパッケージには、暗号化または復号化するメッセージはありませんが、チェックできる整合性 ハッシュ が提供されます。

構文

SECURITY_STATUS SEC_Entry EncryptMessage(
  _In_    PCtxtHandle    phContext,
  _In_    ULONG          fQOP,
  _Inout_ PSecBufferDesc pMessage,
  _In_    ULONG          MessageSeqNo
);

パラメーター

phContext [in]

メッセージの暗号化に使用する セキュリティ コンテキスト のハンドル。

fQOP [in]

保護の品質を示すパッケージ固有のフラグ。 セキュリティ パッケージでは、このパラメーターを使用して暗号化アルゴリズムの選択を有効にすることができます。

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

pMessage [in, out]

SecBufferDesc 構造体へのポインター。 入力時に、構造体は、SECBUFFER_DATA型にすることができる 1 つ以上の SecBuffer 構造体を参照します。 そのバッファーには、暗号化するメッセージが含まれています。 メッセージは所定の場所で暗号化され、構造の元の内容が上書きされます。

この関数は、SECBUFFER_READONLY属性を持つバッファーを処理しません。

メッセージを含む SecBuffer 構造体の長さは、QueryContextAttributes (NTLM) (SECPKG_ATTR_STREAM_SIZES) 関数から取得される cbMaximumMessage を超えてはなりません。

SSL を使用しないアプリケーションでは、種類が SECBUFFER_PADDING の SecBuffer を指定する必要があります。

MessageSeqNo [in]

トランスポート アプリケーションがメッセージに割り当てたシーケンス番号。 トランスポート・アプリケーションがシーケンス番号を維持しない場合、このパラメーターはゼロでなければなりません。

戻り値

関数が成功した場合、関数はSEC_E_OKを返します。

関数が失敗すると、次のいずれかのエラー コードが返されます。

注釈

EncryptMessage (NTLM) 関数は、セキュリティ コンテキストからのメッセージとセッション キーに基づいてメッセージを暗号化します。

トランスポート アプリケーションがシーケンス検出をサポートする セキュリティ コンテキスト を作成し、呼び出し元がシーケンス番号を提供する場合、関数には暗号化されたメッセージにこの情報が含まれます。 この情報を含めると、メッセージの再生、挿入、抑制から保護されます。 セキュリティ パッケージには、トランスポート アプリケーションから渡されたシーケンス番号が組み込まれています。

パフォーマンスを最適化するために、 pMessage 構造体を連続するメモリから割り当てる必要があります。

Windows XP: この関数は SealMessage とも呼ばれます。 アプリケーションでは、 EncryptMessage (NTLM) のみを使用する必要があります。

必要条件

こちらもご覧ください

• SSPI 関数
• AcceptSecurityContext (NTLM)
• DecryptMessage (NTLM)
• InitializeSecurityContext (NTLM)
• QueryContextAttributes (NTLM)
• SecBuffer
• SecBufferDesc