Previous section.

Systems Management: Software License Use Management (XSLM)
Copyright © 1999 The Open Group

NAME

xslm_basic_release_license

SYNOPSIS

#include <libxslm.h>

xslm_uint32 xslm_basic_release_license(
    xslm_handle lic_handle,
    xslm_uint32 * status
);


DESCRIPTION

xslm_basic_release_license() releases all license units related to and acquired via a prior call to xslm_basic_request_license()

INPUT PARAMETERS

lic_handle

A reference returned by xslm_basic_request_license(). It is used to store information about a request/release transaction for a particular product.

OUTPUT PARAMETERS

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 error codes, see ERRORS.

RETURN VALUE

XSLM_OK

License obtained

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_LICENSE_HANDLE The specified handle is invalid
  XSLM_BAD_PARM One or more parameters were not correct
  XSLM_INVALID_API_USE Attempt to combine basic and advanced API for same handle

SEE ALSO

xslm_basic_request_license().

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index