ids_register_provider()

Register your application with an identity provider.

Synopsis:

#include <ids.h>

IDS_API ids_result_t ids_register_provider(const char *name, ids_provider_t **provider, int *fd)

Since:

BlackBerry 10.2.0

Arguments:

name: The name of the identity provider that your app will use to retrieve user identity information.

provider: The updated identity provider if the function completes successfully, or errno set to EEXIST if it fails.

fd: If the function completes successfully, or fails with errno set to EEXIST, this parameter is populated with a file descriptor (fd) that the library can use to communicate with the identity provider. Your application must listen to this fd for input and call ids_process_msg to handle any input provided. The fd may be the same as a fd from a previously added identity provider. Your application must handle unique and repeated fd values when adding them to its monitoring mechanism, and your application should monitor the fd for input and exceptions.

Library:

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

Description:

You can use this function to register your application for each identity provider (such as BlackBerry ID) that your application might use.

Errors The value of errno can be one of the following: EFAULT: The library has not been initialized.ECOMM: Unable to communicate with the identity provider.EEXIST: The identity provider has already been registered.EINVAL: An invalid parameter was passed to the function.ENOMEM: The system has insufficient memory to complete the operation.

Returns:

IDS_SUCCESS if the identity provider was successfully added for the application, or IDS_FAILURE with the errno value set otherwise.