SSLEngine.Wrap Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| Wrap(ByteBuffer, ByteBuffer) |
Tenta codificar um buffer de dados de aplicativo de texto não criptografado em dados de rede SSL/TLS. |
| Wrap(ByteBuffer[], ByteBuffer) |
Tenta codificar bytes de texto não criptografado de uma sequência de buffers de dados em dados de rede SSL/TLS. |
| Wrap(ByteBuffer[], Int32, Int32, ByteBuffer) |
Tenta codificar bytes de texto não criptografado de uma subsequência de buffers de dados em dados de rede SSL/TLS. |
Wrap(ByteBuffer, ByteBuffer)
Tenta codificar um buffer de dados de aplicativo de texto não criptografado em dados de rede 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.SSLEngineResultParâmetros
- src
- ByteBuffer
um ByteBuffer aplicativo de saída contendo dados
- dst
- ByteBuffer
a ByteBuffer para manter os dados de rede de saída
Retornos
uma SSLEngineResult descrição do resultado dessa operação.
- Atributos
Exceções
se ocorreu um problema durante o processamento dos dados.
se o buffer de destino for somente leitura.
se src ou dst for null.
se o mecanismo não tiver todas as configurações necessárias (por exemplo, modo cliente/servidor não definido).
Comentários
Tenta codificar um buffer de dados de aplicativo de texto não criptografado em dados de rede SSL/TLS.
Uma invocação desse método se comporta exatamente da mesma maneira que a invocação: <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(new ByteBuffer [] { src }, 0, 1, dst);}
</blockquote>
Documentação Java para javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer, java.nio.ByteBuffer).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Aplica-se a
Wrap(ByteBuffer[], ByteBuffer)
Tenta codificar bytes de texto não criptografado de uma sequência de buffers de dados em dados de rede 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.SSLEngineResultParâmetros
- srcs
- ByteBuffer[]
uma matriz de contenção dos ByteBuffers dados do aplicativo de saída
- dst
- ByteBuffer
a ByteBuffer para manter os dados de rede de saída
Retornos
uma SSLEngineResult descrição do resultado dessa operação.
- Atributos
Exceções
se ocorreu um problema durante o processamento dos dados.
se o buffer de destino for somente leitura.
se srcs ou dst for null.
se o mecanismo não tiver todas as configurações necessárias (por exemplo, modo cliente/servidor não definido).
Comentários
Tenta codificar bytes de texto não criptografado de uma sequência de buffers de dados em dados de rede SSL/TLS.
Uma invocação desse método se comporta exatamente da mesma maneira que a invocação: <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(srcs, 0, srcs.length, dst);}
</blockquote>
Documentação Java para javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer[], java.nio.ByteBuffer).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Aplica-se a
Wrap(ByteBuffer[], Int32, Int32, ByteBuffer)
Tenta codificar bytes de texto não criptografado de uma subsequência de buffers de dados em dados de rede 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.SSLEngineResultParâmetros
- srcs
- ByteBuffer[]
uma matriz de contenção dos ByteBuffers dados do aplicativo de saída
- offset
- Int32
O deslocamento dentro da matriz de buffer do primeiro buffer do qual os bytes devem ser recuperados; ele deve ser não negativo e não maior do que srcs.length
- length
- Int32
O número máximo de buffers a serem acessados; deve ser não negativo e não maior que srcs.length - offset
- dst
- ByteBuffer
a ByteBuffer para manter os dados de rede de saída
Retornos
uma SSLEngineResult descrição do resultado dessa operação.
- Atributos
Exceções
se ocorreu um problema durante o processamento dos dados.
se length for maior que srcs.length - offset.
se o buffer de destino for somente leitura.
se srcs, dstou uma das entradas em srcs é null.
se o mecanismo não tiver todas as configurações necessárias (por exemplo, modo cliente/servidor não definido).
Comentários
Tenta codificar bytes de texto não criptografado de uma subsequência de buffers de dados em dados de rede SSL/TLS. Essa operação de "coleta" codifica, em uma única invocação, uma sequência de bytes de uma ou mais de uma determinada sequência de buffers. A coleta de encapsulamentos geralmente é útil ao implementar protocolos de rede ou formatos de arquivo que, por exemplo, agrupam dados em segmentos que consistem em um ou mais cabeçalhos de comprimento fixo seguidos por um corpo de comprimento variável. Confira java.nio.channels.GatheringByteChannel mais informações sobre a coleta e java.nio.channels.GatheringByteChannel#write(ByteBuffer[], int, int) para obter mais informações sobre o comportamento de subsequência.
Dependendo do estado do SSLEngine, esse método pode produzir dados de rede sem consumir dados do aplicativo (por exemplo, ele pode gerar dados de handshake).)
O aplicativo é responsável por transportar de forma confiável os dados de rede para o par e para garantir que os dados criados por várias chamadas para wrap() sejam transportados na mesma ordem em que foram gerados. O aplicativo deve sincronizar corretamente várias chamadas para esse método.
Se isso SSLEngine ainda não tiver iniciado seu handshake inicial, esse método iniciará automaticamente o handshake.
Esse método tentará produzir registros SSL/TLS e consumirá o máximo possível de dados de origem, mas nunca consumirá mais do que a soma dos bytes restantes em cada buffer. Cada ByteBufferposição é atualizada para refletir a quantidade de dados consumidos ou produzidos. Os limites permanecem os mesmos.
A memória subjacente usada pelos srcs e dst ByteBuffers não deve ser a mesma.
Consulte a descrição da classe para obter mais informações sobre o fechamento do mecanismo.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.