NLSInstallCertificate(3nw)


NLSInstallCertificate -- installs a license certificate into the specified licensing system

Synopsis

   LS_STATUS_CODE NLSInstallCertificate( 
      LS_STR     *licenseSystem, 
      LS_STR     *serverName, 
      LS_ULONG    licenseLength, 
      LS_VOID    *licenseCertificate, 
      LS_ULONG    passwordLength, 
      LS_VOID    *activationPassword); 

Description

The parameters are as follows:

licenseSystem
(IN) Points to the licensing system in which to install the license certificate. This should be either a value retrieved by LSEnumProviders or LS_ANY. If LS_ANY is specified, the licensing systems are tried in turn until the license certificate is successfully installed.

serverName
(IN) Points to the server name onto which the license certificate should be placed or LS_ANY. If LS_ANY is specified, the license certificate is installed onto the locally attached LSP (or its closest neighbor if the local LSP does not support a local database).

licenseLength
(IN) Specifies the total length of the license certificate to install, in bytes.

licenseCertificate
(IN) Points to a block of data representing a license certificate in the standard license certificate format.

passwordLength
(IN) Specifies the length of the activation password for the provided license certificate.

activationPassword
(IN) Points to the password required for activating the license certificate information provided in licenseCertificate.

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.

LS_AUTHORIZATION_UNAVAILABLE
Specified license certificate could not be located, or you do not have privileges to delete this license certificate.

Notices

NLSInstallCertificate installs a license certificate into the specified licensing system and into the database specified by serverName. The license certificate is ``activated`` with the provided activation password. This password initializes the authentication information that can be associated with a license certificate.

The licensing system initially assigns ownership of the license certificate to the user who invoked this procedure. To change ownership, call NLSTransferOwnership.


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.