Fix DomainParticipant::register_remote_type return when negotiating t…

…ype (#3786) (#3797)

* Refs #19359: Change ReturnCode when negotiating through type lookup service

Signed-off-by: Eduardo Ponz <eduardoponz@eprosima.com>

* Refs #19359: Improve API reference

Signed-off-by: Eduardo Ponz <eduardoponz@eprosima.com>

* Refs #19359: Apply suggestions

Signed-off-by: Eduardo Ponz <eduardoponz@eprosima.com>

---------

Signed-off-by: Eduardo Ponz <eduardoponz@eprosima.com>
(cherry picked from commit 107ea8d)

Co-authored-by: Eduardo Ponz Segrelles <eduardoponz@eprosima.com>

include/fastdds/dds/domain/DomainParticipant.hpp

@@ -850,19 +850,21 @@ class DomainParticipant : public Entity
             const fastrtps::types::TypeIdentifierSeq& in) const;
 
     /**
-     * Helps the user to solve all dependencies calling internally to the typelookup service
-     * and registers the resulting dynamic type.
-     * The registration will be perform asynchronously and the user will be notified through the
-     * given callback, which receives the type_name as unique argument.
-     * If the type is already registered, the function will return true, but the callback will not be called.
-     * If the given type_information is enough to build the type without using the typelookup service,
-     * it will return true and the callback will be never called.
+     * Helps the user to solve all dependencies calling internally to the type lookup service and
+     * registers the resulting dynamic type.
+     * The registration may be perform asynchronously, case in which the user will be notified
+     * through the given callback, which receives the type_name as unique argument.
      *
      * @param type_information
      * @param type_name
      * @param callback
-     * @return true if type is already available (callback will not be called). false if type isn't available yet
-     * (the callback will be called if negotiation is success, and ignored in other case).
+     * @return RETCODE_OK If the given type_information is enough to build the type without using
+     *         the typelookup service (callback will not be called).
+     * @return RETCODE_OK if the given type is already available (callback will not be called).
+     * @return RETCODE_NO_DATA if type is not available yet (the callback will be called if
+     *         negotiation is success, and ignored in other case).
+     * @return RETCODE_NOT_ENABLED if the DomainParticipant is not enabled.
+     * @return RETCODE_PRECONDITION_NOT_MET if the DomainParticipant type lookup service is disabled.
      */
     RTPS_DllAPI ReturnCode_t register_remote_type(
             const fastrtps::types::TypeInformation& type_information,

src/cpp/fastdds/domain/DomainParticipantImpl.cpp

@@ -1801,7 +1801,7 @@ ReturnCode_t DomainParticipantImpl::register_remote_type(
         // Move the filled vector to the map
         parent_requests_.emplace(std::make_pair(requestId, std::move(vector)));
 
-        return ReturnCode_t::RETCODE_OK;
+        return ReturnCode_t::RETCODE_NO_DATA;
     }
     return ReturnCode_t::RETCODE_PRECONDITION_NOT_MET;
 }

src/cpp/fastdds/domain/DomainParticipantImpl.hpp

@@ -489,6 +489,23 @@ class DomainParticipantImpl
     fastrtps::rtps::SampleIdentity get_types(
             const fastrtps::types::TypeIdentifierSeq& in) const;
 
+    /**
+     * Helps the user to solve all dependencies calling internally to the typelookup service and
+     * registers the resulting dynamic type.
+     * The registration may be perform asynchronously, case in which the user will be notified
+     * through the given callback, which receives the type_name as unique argument.
+     *
+     * @param type_information
+     * @param type_name
+     * @param callback
+     * @return RETCODE_OK If the given type_information is enough to build the type without using
+     *         the typelookup service (callback will not be called).
+     * @return RETCODE_OK if the given type is already available (callback will not be called).
+     * @return RETCODE_NO_DATA if type is not available yet (the callback will be called if
+     *         negotiation is success, and ignored in other case).
+     * @return RETCODE_NOT_ENABLED if the DomainParticipant is not enabled.
+     * @return RETCODE_PRECONDITION_NOT_MET if the DomainParticipant type lookup service is disabled.
+     */
     ReturnCode_t register_remote_type(
             const fastrtps::types::TypeInformation& type_information,
             const std::string& type_name,