SslEncryptPacket 関数

SslEncryptPacket 関数は、単一の Secure Sockets Layer プロトコル (SSL) パケットを暗号化します。

構文

SECURITY_STATUS WINAPI SslEncryptPacket(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _Inout_ NCRYPT_KEY_HANDLE  hKey,
  _In_    PBYTE              *pbInput,
  _In_    DWORD              cbInput,
  _Out_   PBYTE              pbOutput,
  _In_    DWORD              cbOutput,
  _Out_   DWORD              *pcbResult,
  _In_    ULONGLONG          SequenceNumber,
  _In_    DWORD              dwContentType,
  _In_    DWORD              dwFlags
);

パラメーター

hSslProvider [in]

SSL プロトコル プロバイダー インスタンスのハンドル。

hKey [in, out]

パケットの暗号化に使用されるキーへのハンドル。

pbInput [in]

暗号化するパケットを含むバッファーへのポインター。

cbInput [in]

pbInput バッファーの長さ (バイト単位)。

pbOutput [out]

暗号化されたパケットを受信するバッファーへのポインター。

cbOutput [in]

pbOutput バッファーの長さ (バイト)。

pcbResult [out]

pbOutput バッファーに書き込まれたバイト数。

SequenceNumber [in]

このパケットに対応するシーケンス番号。

dwContentType [in]

このパケットに対応するコンテンツ タイプ。これは、囲まれたパケットの処理に使用される上位レベルのプロトコルを指定します。

値	説明
CT_CHANGE_CIPHER_SPEC 20	暗号戦略の変更を示します。
CT_ALERT 21	囲まれたパケットにアラートが含まれていることを示します。
CT_HANDSHAKE 22	囲まれたパケットがハンドシェイク プロトコルの一部であることを示します。
CT_APPLICATIONDATA 23	パケットにアプリケーション データが含まれていることを示します。

dwFlags [in]

このパラメーターは将来使用するために予約されています。

戻り値

関数が成功すると、0 が返されます。

関数が失敗すると、0 以外のエラー値が返されます。

可能なリターン コードには、次のものが含まれますが、これらに限定されません。

リターン コード/値	説明
NTE_INVALID_HANDLE 0x80090026L	指定されたハンドルの 1 つが無効です。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	Sslprovider.h
[DLL]	Ncrypt.dll