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.