Functions
void	change_principal (SESSION_T *session, const CHANGE_PRINCIPAL_PARAMS_T params)
	Issue a request to change the principal for the current (active) session. More...

bool	diffusion_get_global_permissions (SESSION_T session, const DIFFUSION_GET_GLOBAL_PERMISSIONS_PARAMS_T params, DIFFUSION_API_ERROR api_error)
	Query the global permissions assigned to the calling session. More...

bool	diffusion_get_path_permissions (SESSION_T session, const DIFFUSION_GET_PATH_PERMISSIONS_PARAMS_T params, DIFFUSION_API_ERROR api_error)
	Query the path permissions assigned to the calling session on a given path. More...

Detailed Description

Function Documentation

void change_principal	(	SESSION_T *	session,
		const CHANGE_PRINCIPAL_PARAMS_T	params
	)

Issue a request to change the principal for the current (active) session.

Parameters

session	The session handle. If NULL, this function has no effect.
params	Parameters defining the change_prinicpal() request and notification callbacks.

bool diffusion_get_global_permissions	(	SESSION_T *	session,
		const DIFFUSION_GET_GLOBAL_PERMISSIONS_PARAMS_T	params,
		DIFFUSION_API_ERROR *	api_error
	)

Query the global permissions assigned to the calling session.

Parameters

session	The session handle. If NULL, this function returns immediately.
params	Parameters describing the `diffusion_get_global_permissions` request and callback handlers which may be invoked in response.
api_error	Populated on API error. Can be NULL.

Returns: true if the operation was successful. False, otherwise. In this case, if a non-NULL api_error pointer has been provided, this will be populated with the error information and should be freed with diffusion_api_error_free.

bool diffusion_get_path_permissions	(	SESSION_T *	session,
		const DIFFUSION_GET_PATH_PERMISSIONS_PARAMS_T	params,
		DIFFUSION_API_ERROR *	api_error
	)

Query the path permissions assigned to the calling session on a given path.

Parameters

session	The session handle. If NULL, this function returns immediately.
params	Parameters describing the `diffusion_get_path_permissions` request and callback handlers which may be invoked in response.
api_error	Populated on API error. Can be NULL.

Returns: true if the operation was successful. False, otherwise. In this case, if a non-NULL api_error pointer has been provided, this will be populated with the error information and should be freed with diffusion_api_error_free.