摘要
建立通訊端。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_socket_create(uint32_t options,
zx_handle_t* out0,
zx_handle_t* out1);
說明
zx_socket_create()
會建立通訊端 (一對雙向串流傳輸),可僅移動資料,且具有最大容量。
寫入單一帳號代碼的資料可以從相反方向讀取。
「options」必須設定 ZX_SOCKET_STREAM
或 ZX_SOCKET_DATAGRAM
標記。
權限
呼叫端工作政策必須允許 ZX_POL_NEW_SOCKET
。
傳回值
zx_socket_create()
會在成功時傳回 ZX_OK
。萬一失敗,系統會傳回下列其中一個值。
錯誤
ZX_ERR_INVALID_ARGS
out0 或 out1 是無效的指標,或是 NULL,或者 options 是 ZX_SOCKET_STREAM
或 ZX_SOCKET_DATAGRAM
以外的任何值。
ZX_ERR_NO_MEMORY
因記憶體不足而失敗。使用者空間無法以任何方式處理這個錯誤 (極可能) 錯誤。日後的建構作業不會再發生這個錯誤。
限制
目前無法設定容量上限。