Function rmw_service_endpoint_info_set_endpoint_count
Defined in File service_endpoint_info.h
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_countargument to the data structure’sendpoint_countmember.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_typemember of the givenservice_endpointwhile setting it.
- Parameters:
service_endpoint_info – [inout] Data structure to be populated.
endpoint_count – [in] Endpoint count to be set.
- Returns:
RMW_RET_OKif successful, or- Returns:
RMW_RET_INVALID_ARGUMENTifservice_endpoint_infois NULL, or- Returns:
RMW_RET_INVALID_ARGUMENTif ‘endpoint_count’ is not 1 or 2, or- Returns:
RMW_RET_ERRORwhen an unspecified error occurs.