IpSecManager.ApplyTransportModeTransform Methode

[Android.Runtime.Register("applyTransportModeTransform", "(Ljava/io/FileDescriptor;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_io_FileDescriptor_ILandroid_net_IpSecTransform_Handler", ApiSince=28)]
public virtual void ApplyTransportModeTransform(Java.IO.FileDescriptor socket, Android.Net.IpSecTransportDirection direction, Android.Net.IpSecTransform transform);

[<Android.Runtime.Register("applyTransportModeTransform", "(Ljava/io/FileDescriptor;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_io_FileDescriptor_ILandroid_net_IpSecTransform_Handler", ApiSince=28)>]
abstract member ApplyTransportModeTransform : Java.IO.FileDescriptor * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit
override this.ApplyTransportModeTransform : Java.IO.FileDescriptor * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit

Parameter

Attribute

RegisterAttribute

Hinweise

Dies wendet die Transportmoduskapselung auf den angegebenen Socket an. Sobald sie angewendet wurde, wird E/A auf dem Socket entsprechend den Parametern der IpSecTransform. Wenn die Transformation durch Aufrufen #removeTransportModeTransformsvon ungeschütztem Datenverkehr aus dem Socket entfernt wird, kann der Datenverkehr in diesem Socket fortgesetzt werden.

Aus Sicherheitsgründen muss die Zieladresse eines datenverkehrs im Socket mit der Remoteadresse InetAddress des IpSecTransformSockets übereinstimmen. Versuche, Datenverkehr an eine andere IP-Adresse zu senden, führt zu einer IOException. Darüber hinaus löst Lese- und Schreibvorgänge im Socket IOException aus, wenn der Benutzer die Transformation (durch Aufrufen) ohne Aufruf IpSecTransform#close()#removeTransportModeTransformsdeaktiviert.

Beachten Sie, dass bei Anwendung auf TCP-Sockets das Aufrufen IpSecTransform#close() einer angewendeten Transformation vor Abschluss des ordnungsgemäßen Herunterfahrens dazu führen kann, dass die Abschaltung nicht abgeschlossen ist. Daher müssen Anwendungen, die das ordnungsgemäße Herunterfahren erfordern, den Socket schließen, bevor die angewendete Transformation deaktiviert wird. Das Schließen des Sockets kann asynchron (in Batches) durchgeführt werden, sodass die Rückgabe einer Close-Funktion das Herunterfahren eines Sockets nicht garantiert. Das Festlegen eines SO_LINGER Timeouts führt dazu, dass das Schließen des Sockets synchron ausgeführt wird und ausreichend ist, um das Herunterfahren sicherzustellen.

Wenn die Transformation deaktiviert wird (durch Aufrufen IpSecTransform#close()), vor dem Schließen des Sockets, werden die Standardpakete [FIN - FIN - FIN/ACK - ACK] oder die Zurücksetzungspakete [RST] aufgrund der fehlenden gültigen Transformation verworfen. Wenn ein Socket ohne den SO_LINGER Optionssatz geschlossen wird, können die verzögerten/batchierten FIN-Pakete verworfen werden.

<h4>Rekey Procedure</h4>

Wenn Sie eine neue Tranform auf einen Socket in ausgehender Richtung anwenden, wird die vorherige Transformation entfernt, und die neue Transformation wird sofort wirksam und sendet den gesamten Datenverkehr an die neue Transformation; Wenn Sie jedoch eine Transformation in eingehender Richtung anwenden, wird der Datenverkehr für die alte Transformation weiterhin entschlüsselt und übermittelt, bis diese Transformation durch Aufrufe IpSecTransform#close()verarbeitet wird. Diese Überlappung ermöglicht verlustlose Neuschlüsselprozeduren, bei denen beide Transformationen gültig sind, bis beide Endpunkte die neue Transformation verwenden und alle In-Flight-Pakete empfangen wurden.

Java Dokumentation für android.net.IpSecManager.applyTransportModeTransform(java.io.FileDescriptor, int, android.net.IpSecTransform).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

[Android.Runtime.Register("applyTransportModeTransform", "(Ljava/net/DatagramSocket;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_net_DatagramSocket_ILandroid_net_IpSecTransform_Handler", ApiSince=28)]
public virtual void ApplyTransportModeTransform(Java.Net.DatagramSocket socket, Android.Net.IpSecTransportDirection direction, Android.Net.IpSecTransform transform);

[<Android.Runtime.Register("applyTransportModeTransform", "(Ljava/net/DatagramSocket;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_net_DatagramSocket_ILandroid_net_IpSecTransform_Handler", ApiSince=28)>]
abstract member ApplyTransportModeTransform : Java.Net.DatagramSocket * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit
override this.ApplyTransportModeTransform : Java.Net.DatagramSocket * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit

Parameter

Attribute

RegisterAttribute

Hinweise

Dies wendet die Transportmoduskapselung auf den angegebenen Socket an. Sobald sie angewendet wurde, wird E/A auf dem Socket entsprechend den Parametern der IpSecTransform. Wenn die Transformation durch Aufrufen #removeTransportModeTransformsvon ungeschütztem Datenverkehr aus dem Socket entfernt wird, kann der Datenverkehr in diesem Socket fortgesetzt werden.

Aus Sicherheitsgründen muss die Zieladresse eines datenverkehrs im Socket mit der Remoteadresse InetAddress des IpSecTransformSockets übereinstimmen. Versuche, Datenverkehr an eine andere IP-Adresse zu senden, führt zu einer IOException. Darüber hinaus löst Lese- und Schreibvorgänge im Socket IOException aus, wenn der Benutzer die Transformation (durch Aufrufen) ohne Aufruf IpSecTransform#close()#removeTransportModeTransformsdeaktiviert.

<h4>Rekey Procedure</h4>

Wenn Sie eine neue Tranform auf einen Socket in ausgehender Richtung anwenden, wird die vorherige Transformation entfernt, und die neue Transformation wird sofort wirksam und sendet den gesamten Datenverkehr an die neue Transformation; Wenn Sie jedoch eine Transformation in eingehender Richtung anwenden, wird der Datenverkehr für die alte Transformation weiterhin entschlüsselt und übermittelt, bis diese Transformation durch Aufrufe IpSecTransform#close()verarbeitet wird. Diese Überlappung ermöglicht verlustlose Neuschlüsselprozeduren, bei denen beide Transformationen gültig sind, bis beide Endpunkte die neue Transformation verwenden und alle In-Flight-Pakete empfangen wurden.

Java Dokumentation für android.net.IpSecManager.applyTransportModeTransform(java.net.DatagramSocket, int, android.net.IpSecTransform).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

[Android.Runtime.Register("applyTransportModeTransform", "(Ljava/net/Socket;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_net_Socket_ILandroid_net_IpSecTransform_Handler", ApiSince=28)]
public virtual void ApplyTransportModeTransform(Java.Net.Socket socket, Android.Net.IpSecTransportDirection direction, Android.Net.IpSecTransform transform);

[<Android.Runtime.Register("applyTransportModeTransform", "(Ljava/net/Socket;ILandroid/net/IpSecTransform;)V", "GetApplyTransportModeTransform_Ljava_net_Socket_ILandroid_net_IpSecTransform_Handler", ApiSince=28)>]
abstract member ApplyTransportModeTransform : Java.Net.Socket * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit
override this.ApplyTransportModeTransform : Java.Net.Socket * Android.Net.IpSecTransportDirection * Android.Net.IpSecTransform -> unit

Parameter

Attribute

RegisterAttribute

Hinweise

Dies wendet die Transportmoduskapselung auf den angegebenen Socket an. Sobald sie angewendet wurde, wird E/A auf dem Socket entsprechend den Parametern der IpSecTransform. Wenn die Transformation durch Aufrufen #removeTransportModeTransformsvon ungeschütztem Datenverkehr aus dem Socket entfernt wird, kann der Datenverkehr in diesem Socket fortgesetzt werden.

Aus Sicherheitsgründen muss die Zieladresse eines datenverkehrs im Socket mit der Remoteadresse InetAddress des IpSecTransformSockets übereinstimmen. Versuche, Datenverkehr an eine andere IP-Adresse zu senden, führt zu einer IOException. Darüber hinaus löst Lese- und Schreibvorgänge im Socket IOException aus, wenn der Benutzer die Transformation (durch Aufrufen) ohne Aufruf IpSecTransform#close()#removeTransportModeTransformsdeaktiviert.

Beachten Sie, dass bei Anwendung auf TCP-Sockets das Aufrufen IpSecTransform#close() einer angewendeten Transformation vor Abschluss des ordnungsgemäßen Herunterfahrens dazu führen kann, dass die Abschaltung nicht abgeschlossen ist. Daher müssen Anwendungen, die das ordnungsgemäße Herunterfahren erfordern, den Socket schließen, bevor die angewendete Transformation deaktiviert wird. Das Schließen des Sockets kann asynchron (in Batches) durchgeführt werden, sodass die Rückgabe einer Close-Funktion das Herunterfahren eines Sockets nicht garantiert. Das Festlegen eines SO_LINGER Timeouts führt dazu, dass das Schließen des Sockets synchron ausgeführt wird und ausreichend ist, um das Herunterfahren sicherzustellen.

Wenn die Transformation deaktiviert wird (durch Aufrufen IpSecTransform#close()), vor dem Schließen des Sockets, werden die Standardpakete [FIN - FIN - FIN/ACK - ACK] oder die Zurücksetzungspakete [RST] aufgrund der fehlenden gültigen Transformation verworfen. Wenn ein Socket ohne den SO_LINGER Optionssatz geschlossen wird, können die verzögerten/batchierten FIN-Pakete verworfen werden.

<h4>Rekey Procedure</h4>

Wenn Sie eine neue Tranform auf einen Socket in ausgehender Richtung anwenden, wird die vorherige Transformation entfernt, und die neue Transformation wird sofort wirksam und sendet den gesamten Datenverkehr an die neue Transformation; Wenn Sie jedoch eine Transformation in eingehender Richtung anwenden, wird der Datenverkehr für die alte Transformation weiterhin entschlüsselt und übermittelt, bis diese Transformation durch Aufrufe IpSecTransform#close()verarbeitet wird. Diese Überlappung ermöglicht verlustlose Neuschlüsselprozeduren, bei denen beide Transformationen gültig sind, bis beide Endpunkte die neue Transformation verwenden und alle In-Flight-Pakete empfangen wurden.

Java Dokumentation für android.net.IpSecManager.applyTransportModeTransform(java.net.Socket, int, android.net.IpSecTransform).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.