Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Trang này được dịch bởi Cloud Translation API.

nl::Inet::UDPEndPoint

#include <src/inet/UDPEndPoint.h>

Các đối tượng của lớp này đại diện cho các điểm cuối truyền tải UDP.

Tóm tắt

Lớp Nest Inet đóng gói các phương thức để tương tác với điểm cuối truyền tải UDP (các ổ cắm SOCK_DGRAM trên Linux và hệ thống bắt nguồn từ BSD) hoặc các khối kiểm soát giao thức LwIP UDP, vì hệ thống được định cấu hình phù hợp.

Tính kế thừa

Kế thừa từ: nl::Inet::IPEndPointBasis

Hàm công khai
`Bind(IPAddressType addrType, IPAddress addr, uint16_t port, InterfaceId intfId)`	`INET_ERROR` Liên kết điểm cuối với một địa chỉ IP của giao diện.
`BindInterface(IPAddressType addrType, InterfaceId intf)`	`INET_ERROR` Liên kết điểm cuối với một giao diện mạng.
`Close(void)`	`void` Đóng điểm cuối.
`Free(void)`	`void` Đóng điểm cuối và sử dụng lại bộ nhớ của điểm cuối đó.
`GetBoundInterface(void)`	`InterfaceId` Lấy giao diện liên kết trên điểm cuối này.
`GetBoundPort(void)`	`uint16_t`
`Listen(void)`	`INET_ERROR` Chuẩn bị điểm cuối để nhận thông báo UDP.
`SendMsg(const IPPacketInfo pktInfo, Weave::System::PacketBuffer msg, uint16_t sendFlags)`	`INET_ERROR` Gửi thông báo UDP tới một đích đến đã chỉ định.
`SendTo(IPAddress addr, uint16_t port, Weave::System::PacketBuffer *msg, uint16_t sendFlags)`	`INET_ERROR` Từ đồng nghĩa của `SendTo(addr, port, INET_NULL_INTERFACEID, msg, sendFlags)`.
`SendTo(IPAddress addr, uint16_t port, InterfaceId intfId, Weave::System::PacketBuffer *msg, uint16_t sendFlags)`	`INET_ERROR` Gửi tin nhắn UDP tới địa chỉ đích đã chỉ định.

Hàm công khai

Liên kết

INET_ERROR Bind(
  IPAddressType addrType,
  IPAddress addr,
  uint16_t port,
  InterfaceId intfId
)

Liên kết điểm cuối với một địa chỉ IP của giao diện.

Liên kết điểm cuối với địa chỉ IP của giao diện mạng đã chỉ định.

Thông tin chi tiết

Các tham số

`[in] addrType`	phiên bản giao thức của địa chỉ IP
`[in] addr`	địa chỉ IP (phải là địa chỉ giao diện)
`[in] port`	cổng UDP
`[in] intfId`	chỉ báo giao diện mạng tuỳ chọn

Giá trị trả về

`INET_NO_ERROR`	thành công: điểm cuối liên kết với địa chỉ
`INET_ERROR_INCORRECT_STATE`	điểm cuối đã được liên kết trước đó
`INET_NO_MEMORY`	không đủ bộ nhớ cho điểm cuối
`INET_ERROR_UNKNOWN_INTERFACE`	Trên một số nền tảng, giao diện được chỉ định (không bắt buộc) sẽ không xuất hiện.
`INET_ERROR_WRONG_PROTOCOL_TYPE`	`addrType` không khớp với `IPVer`.
`INET_ERROR_WRONG_ADDRESS_TYPE`	`addrType` là `kIPAddressType_Any` hoặc loại `addr` không bằng `addrType`.
`other`	lỗi hệ thống hoặc nền tảng khác

Trên LwIP, không được gọi phương thức này khi đã có khoá ngăn xếp LwIP.

BindInterface

INET_ERROR BindInterface(
  IPAddressType addrType,
  InterfaceId intf
)

Liên kết điểm cuối với một giao diện mạng.

Liên kết điểm cuối với địa chỉ IP của giao diện mạng đã chỉ định.

Thông tin chi tiết

Các tham số

`[in] addrType`	phiên bản giao thức của địa chỉ IP.
`[in] intf`	chỉ báo về giao diện mạng.

Giá trị trả về

`INET_NO_ERROR`	thành công: điểm cuối liên kết với địa chỉ
`INET_NO_MEMORY`	không đủ bộ nhớ cho điểm cuối
`INET_ERROR_NOT_IMPLEMENTED`	chưa hoàn tất quá trình triển khai hệ thống.
`INET_ERROR_UNKNOWN_INTERFACE`	Trên một số nền tảng, giao diện này không xuất hiện.
`other`	lỗi hệ thống hoặc nền tảng khác

Trên LwIP, không được gọi phương thức này khi đã có khoá ngăn xếp LwIP.

Đóng

void Close(
  void
)

Đóng điểm cuối.

Nếu là mState != kState_Closed, sau đó, sẽ đóng điểm cuối và xoá điểm cuối đó khỏi tập hợp các điểm cuối đủ điều kiện cho các sự kiện giao tiếp.

Trên các hệ thống LwIP, không được gọi phương thức này khi đã có khoá ngăn xếp LwIP.

Miễn phí

void Free(
  void
)

Đóng điểm cuối và sử dụng lại bộ nhớ của điểm cuối đó.

Gọi phương thức Close, sau đó gọi phương thức InetLayerBasis::Release để trả đối tượng về nhóm bộ nhớ.

Trên các hệ thống LwIP, không được gọi phương thức này khi đã có khoá ngăn xếp LwIP.

GetBoundInterface

InterfaceId GetBoundInterface(
  void
)

Lấy giao diện liên kết trên điểm cuối này.

Thông tin chi tiết
Trả về	InterfaceId Mã giao diện ràng buộc.

GetBoundPort

uint16_t GetBoundPort(
  void
)

Nghe

INET_ERROR Listen(
  void
)

Chuẩn bị điểm cuối để nhận thông báo UDP.

Nếu State đã là kState_Listening thì không có thao tác nào được thực hiện, nếu không thì mState sẽ được đặt thành kState_Listening và điểm cuối được chuẩn bị để nhận thông báo UDP, theo ngữ nghĩa của nền tảng.

Thông tin chi tiết

Giá trị trả về

`INET_NO_ERROR`	thành công: điểm cuối đã sẵn sàng nhận tin nhắn.
`INET_ERROR_INCORRECT_STATE`	điểm cuối đang nghe.

Trong LwIP, phương thức này không được gọi khi đã có khoá ngăn xếp LwIP

SendMsg

INET_ERROR SendMsg(
  const IPPacketInfo *pktInfo,
  Weave::System::PacketBuffer *msg,
  uint16_t sendFlags
)

Gửi thông báo UDP tới một đích đến đã chỉ định.

 Send the UDP message in \c msg to the destination address and port given in
 \c pktInfo.  If \c pktInfo contains an interface id, the message will be sent
 over the specified interface.  If \c pktInfo contains a source address, the
 given address will be used as the source of the UDP message.

 Where (sendFlags & kSendFlag_RetainBuffer) != 0, calls
 Weave::System::PacketBuffer::Free on behalf of the caller, otherwise this
 method deep-copies \c msg into a fresh object, and queues that for
 transmission, leaving the original \c msg available after return.

Thông tin chi tiết

Các tham số

`[in] pktInfo`	thông tin nguồn và đích của thông báo UDP
`[in] msg`	vùng đệm gói chứa thông báo UDP
`[in] sendFlags`	cờ tuỳ chọn truyền không bắt buộc

Giá trị trả về

`INET_NO_ERROR`	thành công: `msg` đã được đưa vào hàng đợi để truyền.
`INET_ERROR_NOT_SUPPORTED`	hệ thống không hỗ trợ tác vụ được yêu cầu.
`INET_ERROR_WRONG_ADDRESS_TYPE`	địa chỉ đích và địa chỉ giao diện ràng buộc không có phiên bản giao thức hoặc loại địa chỉ phù hợp.
`INET_ERROR_MESSAGE_TOO_LONG`	`msg` không chứa toàn bộ thông báo UDP.
`INET_ERROR_OUTBOUND_MESSAGE_TRUNCATED`	Trên một số nền tảng, chỉ một phần bị cắt bớt của `msg` được đưa vào hàng đợi để truyền.
`other`	lỗi hệ thống hoặc nền tảng khác

SendTo

INET_ERROR SendTo(
  IPAddress addr,
  uint16_t port,
  Weave::System::PacketBuffer *msg,
  uint16_t sendFlags
)

Từ đồng nghĩa của SendTo(addr, port, INET_NULL_INTERFACEID, msg, sendFlags).

SendTo

INET_ERROR SendTo(
  IPAddress addr,
  uint16_t port,
  InterfaceId intfId,
  Weave::System::PacketBuffer *msg,
  uint16_t sendFlags
)

Gửi tin nhắn UDP tới địa chỉ đích đã chỉ định.

 If possible, then this method sends the UDP message \c msg to the
 destination \c addr (with \c intfId used as the scope
 identifier for IPv6 link-local destinations) and \c port with the
 transmit option flags encoded in \c sendFlags.

 Where (sendFlags & kSendFlag_RetainBuffer) != 0, calls
 Weave::System::PacketBuffer::Free on behalf of the caller, otherwise this
 method deep-copies \c msg into a fresh object, and queues that for
 transmission, leaving the original \c msg available after return.

Thông tin chi tiết

Các tham số

`[in] addr`	địa chỉ IP đích
`[in] port`	cổng UDP đích
`[in] intfId`	chỉ báo giao diện mạng tuỳ chọn
`[in] msg`	vùng đệm gói chứa thông báo UDP
`[in] sendFlags`	cờ tuỳ chọn truyền không bắt buộc

Giá trị trả về

`INET_NO_ERROR`	thành công: `msg` đã được đưa vào hàng đợi để truyền.
`INET_ERROR_NOT_SUPPORTED`	hệ thống không hỗ trợ tác vụ được yêu cầu.
`INET_ERROR_WRONG_ADDRESS_TYPE`	địa chỉ đích và địa chỉ giao diện ràng buộc không có phiên bản giao thức hoặc loại địa chỉ phù hợp.
`INET_ERROR_MESSAGE_TOO_LONG`	`msg` không chứa toàn bộ thông báo UDP.
`INET_ERROR_OUTBOUND_MESSAGE_TRUNCATED`	Trên một số nền tảng, chỉ một phần bị cắt bớt của `msg` được đưa vào hàng đợi để truyền.
`other`	lỗi hệ thống hoặc nền tảng khác