client-c  0.7.0
kaa_user.h File Reference

Endpoint-to-user association management for Kaa C SDK. More...

#include <stdbool.h>
#include "kaa_error.h"
#include "kaa_defaults.h"
#include "platform/ext_user_callback.h"
+ Include dependency graph for kaa_user.h:

Go to the source code of this file.

Macros

#define KAA_USER_MANAGER_T
 Kaa user manager structure. More...
 

Typedefs

typedef struct kaa_user_manager_t kaa_user_manager_t
 

Functions

kaa_error_t kaa_user_manager_attach_to_user (kaa_user_manager_t *self, const char *user_external_id, const char *access_token, const char *user_verifier_token)
 Attaches the endpoint to a user entity. The user verification is carried out by the default verifier. More...
 
bool kaa_user_manager_is_attached_to_user (kaa_user_manager_t *self)
 Checks if current endpoint is attached to user. More...
 
kaa_error_t kaa_user_manager_set_attachment_listeners (kaa_user_manager_t *self, const kaa_attachment_status_listeners_t *listeners)
 Sets callback functions to receive notifications when the endpoint gets attached or detached to (from) user. More...
 

Detailed Description

Endpoint-to-user association management for Kaa C SDK.

Manages endpoint's association with a user entity in Kaa.

Definition in file kaa_user.h.

Macro Definition Documentation

#define KAA_USER_MANAGER_T

Kaa user manager structure.

Definition at line 43 of file kaa_user.h.

Typedef Documentation

Definition at line 44 of file kaa_user.h.

Function Documentation

kaa_error_t kaa_user_manager_attach_to_user ( kaa_user_manager_t self,
const char *  user_external_id,
const char *  access_token,
const char *  user_verifier_token 
)

Attaches the endpoint to a user entity. The user verification is carried out by the default verifier.

Use this function to request attachment of the endpoint to a user entity using the specified external authentication credentials. Only endpoints associated with the same user entity can exchange events.

Parameters
[in]selfThe user manager instance.
[in]user_external_idNull-terminated string representing external user ID.
[in]user_access_tokenNull-terminated string representing external access token.
Returns
Error code. Attaches the endpoint to a user entity. The user verification is carried out by the specified verifier.

Use this function to request attachment of the endpoint to a user entity using the specified external authentication credentials. Only endpoints associated with the same user entity can exchange events.

Parameters
[in]selfThe user manager instance.
[in]user_external_idNull-terminated string representing external user ID.
[in]user_access_tokenNull-terminated string representing external access token.
[in]user_verifier_tokenNull-terminated string representing user verifier token.
Returns
Error code.
bool kaa_user_manager_is_attached_to_user ( kaa_user_manager_t self)

Checks if current endpoint is attached to user.

Parameters
[in]selfThe user manager instance.
Returns
TRUE if the endpoint is attached to user, FALSE otherwise.
kaa_error_t kaa_user_manager_set_attachment_listeners ( kaa_user_manager_t self,
const kaa_attachment_status_listeners_t listeners 
)

Sets callback functions to receive notifications when the endpoint gets attached or detached to (from) user.

Parameters
[in]selfThe user manager instance.
[in]listenersA filled in kaa_attachment_status_listeners_t structure.
Returns
Error code.