VpnService.Builder.Establish 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
利用提供給這個建構者的參數建立一個 VPN 介面。
[Android.Runtime.Register("establish", "()Landroid/os/ParcelFileDescriptor;", "GetEstablishHandler")]
public virtual Android.OS.ParcelFileDescriptor? Establish();
[<Android.Runtime.Register("establish", "()Landroid/os/ParcelFileDescriptor;", "GetEstablishHandler")>]
abstract member Establish : unit -> Android.OS.ParcelFileDescriptor
override this.Establish : unit -> Android.OS.ParcelFileDescriptor
傳回
ParcelFileDescriptor
null或是應用程式尚未準備好。
- 屬性
例外狀況
如果某個參數未被作業系統接受。
如果某個參數無法被作業系統套用。
若服務未正確宣告。AndroidManifest.xml
備註
描述符預設為非阻擋,VPN 連線結束時必須關閉。 成功切換後,先前的 VPN 介面會被停用。
利用提供給這個建構者的參數建立一個 VPN 介面。 介面處理 IP 封包,並回傳一個檔案描述符供應用程式存取。 每次讀取都會取得一個發送封包,該封包被路由到介面。 每次寫入都會注入一個與介面接收封包相同的輸入封包。 檔案描述符預設設為非阻塞模式,以避免阻塞 Java 執行緒。 若要在原生空間完全使用檔案描述符,請參見 ParcelFileDescriptor#detachFd()。 當 VPN 連線終止時,應用程式必須關閉檔案描述符。 VPN 介面將被移除,系統會自動恢復網路。
為避免衝突,同時只能有一個啟用的 VPN 介面。 通常網路參數在 VPN 連線的整個期間都不會改變。 應用程式關閉前一個檔案描述符後,建立新的檔案描述符也很常見。 然而,在執行無縫切換時同時擁有兩個介面的情況雖然罕見但並非不可能。 在這種情況下,當新介面成功建立時,舊介面會被停用。 兩個檔案描述符皆有效,但現在發出的封包將被路由到新的介面。 因此,在耗盡舊的檔案描述符後,應用程式必須關閉它並開始使用新的檔案描述符。 若無法建立新介面,現有介面及其檔案描述符保持不變。
若因任何原因無法建立介面,則會拋出例外。 然而,若申請未準備好或被撤銷,此方法會回傳 null 。 這有助於解決其他 VPN 應用程式間可能存在的競爭條件。
Java 文件 android.net.VpnService.Builder.establish()。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。