sntl_licensing_attr_new

Library Information

>This API belongs to the Sentinel RMS licensing library.

>The corresponding header is licensing.h.

Description

Creates a new attribute object in the attr output parameter.

An attribute object is a collection of {key, value} pairs that defines an API function's additional input parameters. For example, the sntl_licensing_login_attr function accepts 'attr' to specify the feature version, required login units and so on. To define the {key, value} pairs, the sntl_licensing_attr_set is to be used.

Refer to Coding a Standard License Authorization/Request for a sample calling sequence of this API.

Syntax

SNTL_DECLARE(sntl_status_t) sntl_licensing_attr_new(sntl_licensing_attr_t **attr);

Argument	Description
attr [out]	Pointer to the attribute object created.

Returns

The status code SNTL_SUCCESS is returned, if successful. Otherwise, a specific status code is returned indicating the reason for failure.

For the complete list of error codes, see Licensing Library Error and Result Codes