NAME

xslm_adv_begin_session

SYNOPSIS

#include <libxslm.h>

xslm_uint32 xslm_adv_begin_session(
    xslm_handle * session_handle,
    xslm_uint32 * status
);

DESCRIPTION

xslm_adv_begin_session() establishes a reference which is used to keep track of composite licensing activities (that is, multiple license requests identified by different handles) as a whole. A session may include license requests for products from one or more publishers.

OUTPUT PARAMETERS"

session_handle

An identifier representing the newly created session.

status

Completion status. Detailed error code directly processable by the caller. This value is set to XSLM_STATUS_OK if no error occurred. For other values, see ERRORS.

RETURN VALUE

XSLM_OK

Session created

XSLM_COMM_ERR

Communications problem

XSLM_RESRC_UNAVL

Local resources unavailable

XSLM_PARM_ERR

Parameter error

ERRORS

The function return value gives an overall indication of the success or failure of the call. In addition, the status parameter will be set to one of the following values, to further help point to the reason for a failed request.

Note:

In the future, additional values may be defined for the status variable. An application must not rely upon these being the only possible values.

Return Value	Status Value	Explanation
XSLM_OK	XSLM_STATUS_OK	No errors occurred
XSLM_COMM_ERR	XSLM_LIC_SYS_NOT_RESP	The licensing system does not respond
XSLM_RESRC_UNAVL	XSLM_NO_RES	Platform dependent
XSLM_PARM_ERR	XSLM_BAD_PARM	One or more parameters were not correct

SEE ALSO

xslm_adv_end_session().