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
送信ネットワーク データを保持するByteBuffer
返品
この操作の結果を説明する SSLEngineResult 。
- 属性
例外
データの処理中に問題が発生した場合は〘。
宛先バッファーが読み取り時の場合は 。
srcまたはdstがnull場合は。
エンジンに必要なすべての設定がない場合 (クライアント/サーバー モードが設定されていない場合など)。
注釈
プレーンテキスト アプリケーション データのバッファーを SSL/TLS ネットワーク データにエンコードしようとします。
このメソッドの呼び出しは、呼び出しとまったく同じ方法で動作します。 <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(new ByteBuffer [] { src }, 0, 1, dst);}
</blockquote>
このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。
適用対象
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
送信ネットワーク データを保持するByteBuffer
返品
この操作の結果を説明する SSLEngineResult 。
- 属性
例外
データの処理中に問題が発生した場合は〘。
宛先バッファーが読み取り時の場合は 。
srcsまたはdstがnull場合は。
エンジンに必要なすべての設定がない場合 (クライアント/サーバー モードが設定されていない場合など)。
注釈
一連のデータ バッファーから SSL/TLS ネットワーク データへのプレーンテキスト バイトのエンコードを試みます。
このメソッドの呼び出しは、呼び出しとまったく同じ方法で動作します。 <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(srcs, 0, srcs.length, dst);}
</blockquote>
このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。
適用対象
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
アクセスするバッファーの最大数。負以外で、 srcs.length>- 以下である必要があります。offset
- dst
- ByteBuffer
送信ネットワーク データを保持するByteBuffer
返品
この操作の結果を説明する SSLEngineResult 。
- 属性
例外
データの処理中に問題が発生した場合は〘。
lengthがsrcs.length - offsetより大きい場合は '。
宛先バッファーが読み取り時の場合は 。
srcs、dst、または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の位置は、消費または生成されたデータの量を反映するように更新されます。 制限は変わりません。
srcsとdst ByteBufferで使用される基になるメモリは同じにすることはできません。
エンジン閉鎖の詳細については、クラスの説明を参照してください。
このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。