Function rmw_service_endpoint_info_set_endpoint_count

Function Documentation

rmw_ret_t rmw_service_endpoint_info_set_endpoint_count(rmw_service_endpoint_info_t *service_endpoint_info, size_t endpoint_count)

Set the endpoint count in the given service endpoint info data structure.

Assigns the value of the endpoint_count argument to the data structure’s endpoint_count member.

Attribute

Adherence

Allocates Memory

No

Thread-Safe

No

Uses Atomics

No

Lock-Free

Yes

Remark

This function sets the RMW error state on failure.

Thread-safety

Setting a member is a reentrant procedure, but access to the service endpoint info data structure is not synchronized. It is not safe to read or write the endpoint_type member of the given service_endpoint while setting it.

Parameters:
  • service_endpoint_info[inout] Data structure to be populated.

  • endpoint_count[in] Endpoint count to be set.

Returns:

RMW_RET_OK if successful, or

Returns:

RMW_RET_INVALID_ARGUMENT if service_endpoint_info is NULL, or

Returns:

RMW_RET_INVALID_ARGUMENT if ‘endpoint_count’ is not 1 or 2, or

Returns:

RMW_RET_ERROR when an unspecified error occurs.