SSLEngine.Wrap Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| Wrap(ByteBuffer, ByteBuffer) |
Tenta di codificare un buffer di dati dell'applicazione in testo non crittografato in dati di rete SSL/TLS. |
| Wrap(ByteBuffer[], ByteBuffer) |
Tenta di codificare byte di testo non crittografato da una sequenza di buffer di dati in dati di rete SSL/TLS. |
| Wrap(ByteBuffer[], Int32, Int32, ByteBuffer) |
Tenta di codificare byte di testo non crittografato da una sottosequenza dei buffer di dati in dati di rete SSL/TLS. |
Wrap(ByteBuffer, ByteBuffer)
Tenta di codificare un buffer di dati dell'applicazione in testo non crittografato in dati di rete 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
Parametri
- src
- ByteBuffer
oggetto ByteBuffer contenente i dati dell'applicazione in uscita
- dst
- ByteBuffer
un ByteBuffer oggetto per contenere i dati di rete in uscita
Valori restituiti
oggetto SSLEngineResult che descrive il risultato di questa operazione.
- Attributi
Eccezioni
se si è verificato un problema durante l'elaborazione dei dati.
se il buffer di destinazione è di sola lettura.
se src o dst è null.
se il motore non dispone di tutte le impostazioni necessarie (ad esempio, la modalità client/server non è impostata).
Commenti
Tenta di codificare un buffer di dati dell'applicazione in testo non crittografato in dati di rete SSL/TLS.
Una chiamata di questo metodo si comporta esattamente come la chiamata: <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(new ByteBuffer [] { src }, 0, 1, dst);}
</blockquote>
Documentazione java per javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer, java.nio.ByteBuffer).
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.
Si applica a
Wrap(ByteBuffer[], ByteBuffer)
Tenta di codificare byte di testo non crittografato da una sequenza di buffer di dati in dati di rete 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
Parametri
- srcs
- ByteBuffer[]
matrice di ByteBuffers contenente i dati dell'applicazione in uscita
- dst
- ByteBuffer
un ByteBuffer oggetto per contenere i dati di rete in uscita
Valori restituiti
oggetto SSLEngineResult che descrive il risultato di questa operazione.
- Attributi
Eccezioni
se si è verificato un problema durante l'elaborazione dei dati.
se il buffer di destinazione è di sola lettura.
se srcs o dst è null.
se il motore non dispone di tutte le impostazioni necessarie (ad esempio, la modalità client/server non è impostata).
Commenti
Tenta di codificare byte di testo non crittografato da una sequenza di buffer di dati in dati di rete SSL/TLS.
Una chiamata di questo metodo si comporta esattamente come la chiamata: <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(srcs, 0, srcs.length, dst);}
</blockquote>
Documentazione java per javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer[], java.nio.ByteBuffer).
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.
Si applica a
Wrap(ByteBuffer[], Int32, Int32, ByteBuffer)
Tenta di codificare byte di testo non crittografato da una sottosequenza dei buffer di dati in dati di rete 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
Parametri
- srcs
- ByteBuffer[]
matrice di ByteBuffers contenente i dati dell'applicazione in uscita
- offset
- Int32
Offset all'interno della matrice di buffer del primo buffer da cui recuperare i byte; deve essere non negativo e non più grande di srcs.length
- length
- Int32
Numero massimo di buffer a cui accedere; deve essere non negativo e non più grande di srcs.length - offset
- dst
- ByteBuffer
un ByteBuffer oggetto per contenere i dati di rete in uscita
Valori restituiti
oggetto SSLEngineResult che descrive il risultato di questa operazione.
- Attributi
Eccezioni
se si è verificato un problema durante l'elaborazione dei dati.
se length è maggiore di srcs.length - offset.
se il buffer di destinazione è di sola lettura.
se srcs, dsto una delle voci in srcs è null.
se il motore non dispone di tutte le impostazioni necessarie (ad esempio, la modalità client/server non è impostata).
Commenti
Tenta di codificare byte di testo non crittografato da una sottosequenza dei buffer di dati in dati di rete SSL/TLS. Questa operazione di "raccolta" codifica, in una singola chiamata, una sequenza di byte da una o più di una determinata sequenza di buffer. I wrapping di raccolta sono spesso utili quando si implementano protocolli di rete o formati di file che, ad esempio, raggruppano i dati in segmenti costituiti da una o più intestazioni a lunghezza fissa seguite da un corpo a lunghezza variabile. Vedere java.nio.channels.GatheringByteChannel per altre informazioni sulla raccolta e java.nio.channels.GatheringByteChannel#write(ByteBuffer[], int, int) per altre informazioni sul comportamento della sottosequenza.
A seconda dello stato di SSLEngine, questo metodo può produrre dati di rete senza utilizzare dati dell'applicazione( ad esempio, può generare dati di handshake).
L'applicazione è responsabile del trasporto affidabile dei dati di rete al peer e per garantire che i dati creati da più chiamate a wrap() vengano trasportati nello stesso ordine in cui è stato generato. L'applicazione deve sincronizzare correttamente più chiamate a questo metodo.
Se l'handshake SSLEngine iniziale non è ancora stato avviato, questo metodo avvierà automaticamente l'handshake.
Questo metodo tenterà di produrre record SSL/TLS e utilizzerà il maggior numero possibile di dati di origine, ma non utilizzerà mai più della somma dei byte rimanenti in ogni buffer. Ogni ByteBufferposizione viene aggiornata in modo da riflettere la quantità di dati utilizzati o prodotti. I limiti rimangono invariati.
La memoria sottostante usata da srcs e dst ByteBuffernon deve essere la stessa.
Per altre informazioni sulla chiusura del motore, vedere la descrizione della classe.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.