NLSMoveCertificate(3nw)
NLSMoveCertificate --
relocates the database record containing the specified license certificate
Synopsis
LS_STATUS_CODE NLSMoveCertificate(
LS_STR
licenseSystem,
LS_STR
publisherName,
LS_STR
productName,
LS_STR
version,
LS_LICENSE_ID licenseID,
LS_STR
newServerName);
Description
The parameters are as follows:
- licenseSystem
-
(IN) Points to the licensing system in which the license certificate to move is located. Specify a specific licensing system name as received from LSEnumProviders, or
specify LS_ANY to initiate a search for the first matching certificate.
- publisher
-
(IN) Points to the publisher name of the license certificate to move to another server. This value is required and cannot be LS_ANY.
- product
-
(IN) Points to the product name of the license certificate to move to another server. This value is required and cannot be LS_ANY.
- version
-
(IN) Points to the version of the license certificate to move to another server. This value is required and cannot be LS_ANY.
- licenseID
-
(IN) Specifies the unique identifier (serial number) of the license certificate to move to another server.
- newServer
-
(IN) Points to the server name that contains the database and LSP to relocate the license certificate to. A valid server name (DN) must be specified.
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
NLSMoveCertificate relocates the physical location of the database record containing the specified license certificate to a database file contained on the server
serverName. If this procedure cannot be completed successfully, the license certificate record remains in the original location.
The user associated with the current connection must be security-equivalent to the owner attribute of the license certificate and must have rights to place a license certificate
on the new server specified.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.