navigator_invoke_query_set

Set the type of a query.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API int navigator_invoke_query_set_type(navigator_invoke_query_t *query,
                                            const char *type)

Since:

BlackBerry 10.0.0

Arguments:

query: A pointer to the navigator_invoke_query_t structure whose type member you want to set.

type: The MIME type you want to query for. The value must conform to the "Type Subtype" format (see description for further information).

Library:

libbps (For the qcc command, use the -l bps option to link against this library)

Description:

The navigator_invoke_query_set_type() function sets the MIME type of a given navigator_invoke_query_t structure. The type member identifies the MIME type the invocation query results must be able to parform an action on.

If you don't assign a type member to an invocation query, the brokering system doesn't filter for any specific MIME type. You must assign this member if you don't assign the file_uri member (using the navigator_invoke_query_set_file_uri() function).

The format of a type member must conform to the following guidelines:

MIME type: Type Subtype
Type: [a-zA-Z0-9-_.]+
Subtype: NUL | / Type Subtype

Example: "image/png"

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.