NLSDeleteCertificate(3nw)
NLSDeleteCertificate --
removes a license certificate record from the license database
Synopsis
LS_STATUS_CODE NLSDeleteCertificate(
LS_STR
licenseSystem,
LS_STR
publisherName,
LS_STR
productName,
LS_STR
version,
LS_LICENSE_ID licenseID);
Description
The parameters are as follows:
- licenseSystem
-
(IN) Points to a licensing system that contains license certificate to be deleted. Specify a specific licensing system name as received from LSEnumProviders, or specify
LS_ANY to initiate a search for the first matching certificate.
- publisherName
-
(IN) Points to the publisher name of the license certificate to delete from the license certificate database (cannot be NULL or LS_ANY).
- productName
-
(IN) Points to the product name of license certificate to delete from the license certificate database (cannot be NULL or LS_ANY).
- version
-
(IN) Points to the version of the license certificate to delete from the license certificate database (cannot be NULL or LS_ANY).
- licenseID
-
(IN) Specifies the unique identifier (serial number) of license certificate to delete from the license certificate database.
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 user does not have privileges to delete this license certificate.
Notices
NLSDeleteCertificate removes the license certificate record from the license database where it is installed, or marks it as unusable. This license certificate is then
no longer visible to any other licensing functions.
The user associated with the current connection must be security-equivalent to the owner attribute of the license certificate.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.