add object Supported in Lease modeSupported in Connected (Cloud LM) mode

Interface Information

>This API belongs to SentinelLicensing.dll.

>The corresponding library is Sentinel RMS licensing library.

void add_object(String key, Attribute value)

Adds an attribute object containing the {key, value} pair in another attribute object.

Parameters

Argument Description
key [in]

The key for the attribute object to be added.

For example, SNTL_ATTR_CONFIG_SCP_PRODUCT_KEY_LIST is the key for adding the Product object.

value [in]

The value of attribute object that is to be added.

For example, pAttrProductKey1 value can be specified for SNTL_ATTR_CONFIG_SCP_PRODUCT_KEY_LIST key.

Attributes

# Attribute for... Key and Description
1 Customer ListSupported in Lease modeSupported in Connected (Cloud LM) mode

>Attribute Key - SNTL_ATTR_CONFIG_SCP_CUSTOMER_LIST

>This attribute is used to add a customer object in the configure object.

>This attribute contains the customer id, which is defined using set API.

Customer id

>Attribute Key - SNTL_ATTR_CONFIG_SCP_CUSTOMERID

>This is a mandatory attribute that determines the specific customer whose product/line item is to be fetched from the entitlements.

2 Product Key ListSupported in Lease modeSupported in Connected (Cloud LM) mode

>Attribute Key - SNTL_ATTR_CONFIG_SCP_PRODUCT_KEY_LIST

>This attribute is used to add product object in the customer object.

>This product object contains the Product key id and product variant attributes (listed below), which is defined using set API.

Product Key id

>Attribute Key - SNTL_ATTR_CONFIG_SCP_PKID

>This is a mandatory attribute that determines the specific product/line item to be fetched from the entitlements.

NOTE   If you don't set this attribute, it would fetch all the products/line items available in an entitlement for the specified customer.

Product Variant

>Attribute Key - SNTL_ATTR_CONFIG_SCP_PRODUCT_VARIANT

>This attribute defines the product variant corresponding to a product/line item to be fetched from the entitlements.

NOTE   You can set this attribute only if product key id is defined.

NOTE   After configuring this attribute, ensure to add it in the customer list attribute.

Returns

The status code SNTL_SUCCESS is returned, if successful. Otherwise, it will return one of the following errors codes:

Error Code Description
SNTL_INVALID_ATTR_KEY The attribute key is invalid.
SNTL_INVALID_ATTR_VALUE The attribute key value is invalid.