SSLEngine.Wrap Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| Wrap(ByteBuffer, ByteBuffer) |
Tente d’encoder une mémoire tampon de données d’application en texte clair dans des données réseau SSL/TLS. |
| Wrap(ByteBuffer[], ByteBuffer) |
Tente d’encoder des octets en texte clair à partir d’une séquence de mémoires tampons de données dans des données réseau SSL/TLS. |
| Wrap(ByteBuffer[], Int32, Int32, ByteBuffer) |
Tente d’encoder des octets en texte clair à partir d’une sous-séquence de mémoires tampons de données dans des données réseau SSL/TLS. |
Wrap(ByteBuffer, ByteBuffer)
Tente d’encoder une mémoire tampon de données d’application en texte clair dans des données réseau 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
Paramètres
- src
- ByteBuffer
contenant ByteBuffer des données d’application sortantes
- dst
- ByteBuffer
a ByteBuffer pour contenir des données réseau sortantes
Retours
SSLEngineResult décrivant le résultat de cette opération.
- Attributs
Exceptions
si un problème s’est produit lors du traitement des données.
si la mémoire tampon de destination est en lecture seule.
si src ou dst est null.
si le moteur n’a pas tous les paramètres nécessaires (par exemple, le mode client/serveur non défini).
Remarques
Tente d’encoder une mémoire tampon de données d’application en texte clair dans des données réseau SSL/TLS.
Un appel de cette méthode se comporte exactement de la même manière que l’appel : <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(new ByteBuffer [] { src }, 0, 1, dst);}
</blockquote>
Java documentation pour javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer, java.nio.ByteBuffer).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
S’applique à
Wrap(ByteBuffer[], ByteBuffer)
Tente d’encoder des octets en texte clair à partir d’une séquence de mémoires tampons de données dans des données réseau 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
Paramètres
- srcs
- ByteBuffer[]
tableau de données d’application ByteBuffers sortantes
- dst
- ByteBuffer
a ByteBuffer pour contenir des données réseau sortantes
Retours
SSLEngineResult décrivant le résultat de cette opération.
- Attributs
Exceptions
si un problème s’est produit lors du traitement des données.
si la mémoire tampon de destination est en lecture seule.
si srcs ou dst est null.
si le moteur n’a pas tous les paramètres nécessaires (par exemple, le mode client/serveur non défini).
Remarques
Tente d’encoder des octets en texte clair à partir d’une séquence de mémoires tampons de données dans des données réseau SSL/TLS.
Un appel de cette méthode se comporte exactement de la même manière que l’appel : <blockquote>
{@link #wrap(ByteBuffer [], int, int, ByteBuffer)
engine.wrap(srcs, 0, srcs.length, dst);}
</blockquote>
Java documentation pour javax.net.ssl.SSLEngine.wrap(java.nio.ByteBuffer[], java.nio.ByteBuffer).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
S’applique à
Wrap(ByteBuffer[], Int32, Int32, ByteBuffer)
Tente d’encoder des octets en texte clair à partir d’une sous-séquence de mémoires tampons de données dans des données réseau 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
Paramètres
- srcs
- ByteBuffer[]
tableau de données d’application ByteBuffers sortantes
- offset
- Int32
Décalage dans le tableau de mémoires tampons du premier tampon à partir duquel les octets doivent être récupérés ; il doit être non négatif et pas plus grand que srcs.length
- length
- Int32
Nombre maximal de mémoires tampons à accéder ; il doit être non négatif et pas plus grand que srcs.length ;- ;offset
- dst
- ByteBuffer
a ByteBuffer pour contenir des données réseau sortantes
Retours
SSLEngineResult décrivant le résultat de cette opération.
- Attributs
Exceptions
si un problème s’est produit lors du traitement des données.
si length est supérieur à srcs.length - offset.
si la mémoire tampon de destination est en lecture seule.
si srcs, dstou l’une des entrées dans srcs est null.
si le moteur n’a pas tous les paramètres nécessaires (par exemple, le mode client/serveur non défini).
Remarques
Tente d’encoder des octets en texte clair à partir d’une sous-séquence de mémoires tampons de données dans des données réseau SSL/TLS. Cette opération de « collecte » encode, dans un appel unique, une séquence d’octets d’une ou plusieurs d’une séquence donnée de mémoires tampons. La collecte des wraps est souvent utile lors de l’implémentation de protocoles réseau ou de formats de fichiers qui, par exemple, regroupent des données dans des segments constitués d’un ou plusieurs en-têtes de longueur fixe suivis d’un corps de longueur variable. Pour java.nio.channels.GatheringByteChannel plus d’informations sur la collecte et java.nio.channels.GatheringByteChannel#write(ByteBuffer[], int, int) pour plus d’informations sur le comportement de sous-file d’attente.
En fonction de l’état de SSLEngine, cette méthode peut produire des données réseau sans consommer de données d’application (par exemple, il peut générer des données de négociation.)
L’application est chargée de transporter de manière fiable les données réseau vers l’homologue et de s’assurer que les données créées par plusieurs appels à wrap() sont transportées dans le même ordre dans lequel elles ont été générées. L’application doit synchroniser correctement plusieurs appels à cette méthode.
Si cette SSLEngine opération n’a pas encore démarré sa négociation initiale, cette méthode démarre automatiquement l’établissement d’une liaison.
Cette méthode tentera de produire des enregistrements SSL/TLS et consommera autant de données sources que possible, mais ne consommera jamais plus que la somme des octets restants dans chaque mémoire tampon. Chaque ByteBufferposition est mise à jour pour refléter la quantité de données consommées ou produites. Les limites restent les mêmes.
La mémoire sous-jacente utilisée par le srcs et dst ByteBufferles s ne doit pas être identique.
Pour plus d’informations sur la fermeture du moteur, consultez la description de la classe.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.