axlList * vortex_connection_get_remote_profiles ( VortexConnection connection)

Returns the remote peer supported profiles.

When a Vortex connection is opened, remote server sends a list of BEEP supported profiles.

This is necessary to be able to create new channels. The profile selected for the channel to be created must be supported for both sides.

This function allows to get remote peer supported profiles. This can be helpful to avoid connection to a remote BEEP peers that actually doesn't support your profile.

You must free the returned axlList. As a example, you can use this function as follows:

1 axlList * profiles = NULL;
2 int iterator = 0;
4 // get a list of profiles supported
5 profiles = vortex_connection_get_remote_profiles (connection);
6 printf ("profiles for this peer: %d\n", axl_list_length (profiles));
8 // for each item do
9 while (iterator < axl_list_length (profiles)) {
10  // show a message
11  printf (" %d) %s\n", iterator, (char *) axl_list_get_nth (profiles, iterator));
13  // update iterator
14  iterator++;
16 } // end while
18 // free the list when no longer needed
19 axl_list_free (profiles);
connectionthe connection to get remote peer profiles.
An axlList containing each element a uri identifying a remote peer profile. Free the list returned with axl_list_free.

References vortex_connection_is_profile_filtered().