navigator_invoke_query_set_perimeter()

#include <bps/navigator_invoke.h>
 

BPS_API int navigator_invoke_query_set_perimeter(navigator_invoke_query_t *query, navigator_invoke_perimeter_type_t perimeter)

Arguments:

query

A pointer to the navigator_invoke_query_t structure whose perimeter member you want to set.

perimeter

The perimeter in which you want the application to be invoked. This value must correspond to an entry in the navigator_invoke_perimeter_type_t enumeration.

Library:

libbps

Description:

The navigator_invoke_query_set_perimeter() function sets the perimeter member of a given navigator_invoke_query_t structure. The perimeter member indicates in which perimeter the resulting targets should reside. Use this function in instances where the query results include "hybrid" applications that can run in both enterprise and personal perimeters. For target applications that aren't hybrids, the perimeter is mandated to be the same as the sender.

If you don't call this function, query results that are hybrid applications set the perimeter value to NAVIGATOR_INVOKE_PERIMETER_TYPE_PERSONAL by default, while results that are non-hybrid applications set the perimeter to the perimeter of the client.

The possible values that you can set to this member are:

• NAVIGATOR_INVOKE_PERIMETER_TYPE_PERSONAL
• NAVIGATOR_INVOKE_PERIMETER_TYPE_ENTERPRISE

See the navigator_invoke_perimeter_type_t enumeration for details.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.