SSLEngine.Wrap メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Wrap(ByteBuffer, ByteBuffer) |
プレーンテキスト アプリケーション データのバッファーを SSL/TLS ネットワーク データにエンコードしようとします。 |
| Wrap(ByteBuffer[], ByteBuffer) |
一連のデータ バッファーから SSL/TLS ネットワーク データにプレーンテキスト バイトをエンコードしようとします。 |
| Wrap(ByteBuffer[], Int32, Int32, ByteBuffer) |
データ バッファーのサブシーケンスから SSL/TLS ネットワーク データにプレーンテキスト バイトをエンコードしようとします。 |
Wrap(ByteBuffer, ByteBuffer)
プレーンテキスト アプリケーション データのバッファーを SSL/TLS ネットワーク データにエンコードしようとします。
[Android.Runtime.Register("wrap", "(Ljava/nio/ByteBuffer;Ljava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_Ljava_nio_ByteBuffer_Ljava_nio_ByteBuffer_Handler")]
public virtual Javax.Net.Ssl.SSLEngineResult? Wrap (Java.Nio.ByteBuffer? src, Java.Nio.ByteBuffer? dst);[<Android.Runtime.Register("wrap", "(Ljava/nio/ByteBuffer;Ljava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_Ljava_nio_ByteBuffer_Ljava_nio_ByteBuffer_Handler")>]
abstract member Wrap : Java.Nio.ByteBuffer * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResult
override this.Wrap : Java.Nio.ByteBuffer * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResultパラメーター
- src
- ByteBuffer
ByteBuffer送信アプリケーション データを含む
- dst
- ByteBuffer
送信ネットワーク データを保持する a ByteBuffer
戻り値
SSLEngineResultこの操作の結果を記述する 。
- 属性
例外
データの処理中に問題が発生した場合は 。
宛先バッファーが読み取り専用の場合は 。
または dst が の場合src。null
エンジンに必要なすべての設定がない場合 (クライアント/サーバー モードが設定されていないなど)。
注釈
プレーンテキスト アプリケーション データのバッファーを SSL/TLS ネットワーク データにエンコードしようとします。
このメソッドの呼び出しは、呼び出しとまったく同じ方法で動作します: <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(new ByteBuffer [] { src }, 0, 1, dst);}
</blockquote>
の javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer, java.nio.ByteBuffer)Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。
適用対象
Wrap(ByteBuffer[], ByteBuffer)
一連のデータ バッファーから SSL/TLS ネットワーク データにプレーンテキスト バイトをエンコードしようとします。
[Android.Runtime.Register("wrap", "([Ljava/nio/ByteBuffer;Ljava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_arrayLjava_nio_ByteBuffer_Ljava_nio_ByteBuffer_Handler")]
public virtual Javax.Net.Ssl.SSLEngineResult? Wrap (Java.Nio.ByteBuffer[]? srcs, Java.Nio.ByteBuffer? dst);[<Android.Runtime.Register("wrap", "([Ljava/nio/ByteBuffer;Ljava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_arrayLjava_nio_ByteBuffer_Ljava_nio_ByteBuffer_Handler")>]
abstract member Wrap : Java.Nio.ByteBuffer[] * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResult
override this.Wrap : Java.Nio.ByteBuffer[] * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResultパラメーター
- srcs
- ByteBuffer[]
送信アプリケーション データを格納する の配列ByteBuffers
- dst
- ByteBuffer
送信ネットワーク データを保持する a ByteBuffer
戻り値
SSLEngineResultこの操作の結果を記述する 。
- 属性
例外
データの処理中に問題が発生した場合は 。
宛先バッファーが読み取り専用の場合は 。
または dst が の場合srcs。null
エンジンに必要なすべての設定がない場合 (クライアント/サーバー モードが設定されていないなど)。
注釈
一連のデータ バッファーから SSL/TLS ネットワーク データにプレーンテキスト バイトをエンコードしようとします。
このメソッドの呼び出しは、呼び出しとまったく同じ方法で動作します: <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(srcs, 0, srcs.length, dst);}
</blockquote>
の javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer[], java.nio.ByteBuffer)Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。
適用対象
Wrap(ByteBuffer[], Int32, Int32, ByteBuffer)
データ バッファーのサブシーケンスから SSL/TLS ネットワーク データにプレーンテキスト バイトをエンコードしようとします。
[Android.Runtime.Register("wrap", "([Ljava/nio/ByteBuffer;IILjava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_arrayLjava_nio_ByteBuffer_IILjava_nio_ByteBuffer_Handler")]
public abstract Javax.Net.Ssl.SSLEngineResult? Wrap (Java.Nio.ByteBuffer[]? srcs, int offset, int length, Java.Nio.ByteBuffer? dst);[<Android.Runtime.Register("wrap", "([Ljava/nio/ByteBuffer;IILjava/nio/ByteBuffer;)Ljavax/net/ssl/SSLEngineResult;", "GetWrap_arrayLjava_nio_ByteBuffer_IILjava_nio_ByteBuffer_Handler")>]
abstract member Wrap : Java.Nio.ByteBuffer[] * int * int * Java.Nio.ByteBuffer -> Javax.Net.Ssl.SSLEngineResultパラメーター
- srcs
- ByteBuffer[]
送信アプリケーション データを格納する の配列ByteBuffers
- offset
- Int32
バイトを取得する最初のバッファーのバッファー配列内のオフセット。負以外の値で、次の値より大きくすることはできません。 srcs.length
- length
- Int32
アクセスするバッファーの最大数。非負であり、nbsp;- &以下 srcs.length である必要があります。offset
- dst
- ByteBuffer
送信ネットワーク データを保持する a ByteBuffer
戻り値
SSLEngineResultこの操作の結果を記述する 。
- 属性
例外
データの処理中に問題が発生した場合は 。
が よりsrcs.length - offset大きい場合length。
宛先バッファーが読み取り専用の場合は 。
、dst、または のsrcsエントリが の場合srcsは null。
エンジンに必要なすべての設定がない場合 (クライアント/サーバー モードが設定されていないなど)。
注釈
データ バッファーのサブシーケンスから SSL/TLS ネットワーク データにプレーンテキスト バイトをエンコードしようとします。 この "収集" 操作は、1 回の呼び出しで、特定のバッファー シーケンスの 1 つ以上からのバイト シーケンスをエンコードします。 ラップの収集は、多くの場合、ネットワーク プロトコルまたはファイル形式を実装する場合に便利です。たとえば、データを 1 つ以上の固定長ヘッダーで構成されるセグメントにグループ化し、その後に可変長本文を続けます。 java.nio.channels.GatheringByteChannel収集の詳細と、java.nio.channels.GatheringByteChannel#write(ByteBuffer[], int, int)サブシーケンスの動作の詳細については、 を参照してください。
SSLEngine の状態によっては、このメソッドはアプリケーション データを使用せずにネットワーク データを生成する場合があります (たとえば、ハンドシェイク データが生成される場合があります)。
アプリケーションは、ネットワーク データをピアに確実に転送し、wrap() の複数の呼び出しによって作成されたデータが、生成されたのと同じ順序で確実に転送されるようにします。 アプリケーションでは、このメソッドへの複数の呼び出しを適切に同期する必要があります。
最初の SSLEngine ハンドシェイクがまだ開始されていない場合、このメソッドはハンドシェイクを自動的に開始します。
このメソッドは SSL/TLS レコードの生成を試み、可能な限り多くのソース データを使用しますが、各バッファーに残っているバイトの合計を超える消費は発生しません。 各 ByteBufferの位置は、消費または生成されたデータの量を反映するように更新されます。 制限は変わりません。
と dst ByteBuffers で使用されるsrcs基になるメモリは同じにすることはできません。
エンジンのクローズの詳細については、クラスの説明を参照してください。
の javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer[], int, int, java.nio.ByteBuffer)Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。