zx_socket_create

摘要

建立通訊端。

宣告

#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_STREAMZX_SOCKET_DATAGRAM 標記。

權限

呼叫端工作政策必須允許 ZX_POL_NEW_SOCKET

傳回值

zx_socket_create() 會在成功時傳回 ZX_OK。萬一失敗,系統會傳回下列其中一個值。

錯誤

ZX_ERR_INVALID_ARGS out0out1 是無效的指標,或是 NULL,或者 optionsZX_SOCKET_STREAMZX_SOCKET_DATAGRAM 以外的任何值。

ZX_ERR_NO_MEMORY 因記憶體不足而失敗。使用者空間無法以任何方式處理這個錯誤 (極可能) 錯誤。日後的建構作業不會再發生這個錯誤。

限制

目前無法設定容量上限。

另請參閱