Function otBorderAgentSetMeshCoPServiceBaseName

pub unsafe extern "C" fn otBorderAgentSetMeshCoPServiceBaseName(
    aInstance: *mut otInstance,
    aBaseName: *const c_char,
) -> otError

Sets the base name to construct the service instance name used when advertising the mDNS _meshcop._udp service by the Border Agent.

Requires the OPENTHREAD_CONFIG_BORDER_AGENT_MESHCOP_SERVICE_ENABLE feature.

The name can also be configured using the OPENTHREAD_CONFIG_BORDER_AGENT_MESHCOP_SERVICE_BASE_NAME configuration option (which is the recommended way to specify this name). This API is provided for projects where the name needs to be set after device initialization and at run-time.

Per the Thread specification, the service instance should be a user-friendly name identifying the device model or product. A recommended format is “ ”.

To construct the full name and ensure name uniqueness, the OpenThread Border Agent module will append the Extended Address of the device (as 16-character hex digits) to the given base name.

Note that the same name will be used for the ephemeral key service _meshcop-e._udp when the ephemeral key feature is enabled and used.

@param[in] aInstance The OpenThread instance. @param[in] aBaseName The base name to use (MUST not be NULL).

@retval OT_ERROR_NONE The name was set successfully. @retval OT_ERROR_INVALID_ARGS The name is too long or invalid.