NLSAddProductInformation(3nw)
NLSAddProductInformation --
adds non-secure license certificate information to the licensing system database
Synopsis
LS_STATUS_CODE NLSAddProductInformation(
LS_STR
licenseSystem,
LS_STR
serverName,
LS_STR
publisherName,
LS_STR
productName,
LS_STR
version,
LS_ULONG licenseUnits,
LS_ULONG attributesLength,
LS_VOID
licenseAttributes);
Description
The parameters are as follows:
- licenseSystem
-
(IN) Points to the name of the licensing system into which this product information should be installed. LS_ANY can be specified, indicating that this information is to
be installed into the first licensing system that supports this procedure.
- serverName
-
(IN) Points to the DN of a specific NetWare server where information will be added. LS_ANY can be specified, indicating that this information should be installed onto
the closest LSP that provides license certificate database services.
- publisherName
-
(IN) Points to the publisher name of the product being installed (cannot be NULL or LS_ANY).
- productName
-
(IN) Points to the product name of the product being installed (cannot be NULL or LS_ANY).
- version
-
(IN) Points to the version of the product being installed (cannot be NULL or LS_ANY).
- licenseUnits
-
(IN) Specifies the number of license units to install for this product.
- attributesLength
-
(IN) Specifies the length of the optional policy attribute section of this information to install. This should be set to zero if no attributes are specified.
- licenseAttributes
-
(IN) Points to a buffer containing the attributes occurring contiguously. These override the corresponding default attributes in the licensing system.
Return values
This function returns a detailed error code that can be directly processed by the caller, or that can be converted by LSGetMessage to one of these message strings:
- LS_SUCCESS
-
The requested functionality completed successfully.
- LS_SYSTEM_UNAVAILABLE
-
DOS TSR or Windows DLL is not properly configured or available, or client has no licensing system to communicate with.
- LS_RESOURCES_UNAVAILABLE
-
Insufficient resources (such as memory) available to complete request.
- LS_BAD_ARG
-
One or more parameters are invalid.
Notices
NLSAddProductInformation allows a software asset management product (or an administrator) to create non-secure metering information in the licensing system databases.
Specific policy attributes about the software's license agreement can be placed into the database along with the product information. This creates an ``internal license`` for the
product, with no security information. These licenses might not be usable by a license-enabled application if the application requires the security information to execute. The
installer of this information becomes the ``owner`` of this information.
NLS creates a unique license ID for license certificate information installed by NLSAddProductInformation.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.