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.