NLSRemoveAssignment(3nw)
NLSRemoveAssignment --
removes an assignment from a license certificate
Synopsis
LS_STATUS_CODE NLSRemoveAssignment(
LS_STR
licenseSystem,
LS_STR
publisher,
LS_STR
product,
LS_STR
version,
LS_LICENSE_ID licenseID,
LS_ULONG assignmentType,
LS_VOID
assignmentInfo,
LS_ULONG assignmentInfoLen);
Description
The parameters are as follows:
- licenseSystem
-
(IN) Points to the licensing systems on which the specified product license certificate exists. It must be the specific name of a licensing system as returned by
LSEnumProviders.
- publisher
-
(IN) Points to the publisher name of the license certificate from which the assignment is removed.
- product
-
(IN) Points to the product name of the license certificate from which the assignment is removed.
- version
-
(IN) Points to the version string of the license certificate from which the assignment is removed.
- licenseID
-
(IN) Specifies the unique identifier (serial number) of the license certificate from which the assignment is removed.
- assignmentType
-
(IN) Specifies the type of assignment to remove. The information placed in assignmentInfo depends on assignmentType.
- assignmentInfo
-
(IN) Points to the exact information for the assignment to remove.
- assignmentInfoLen
-
(IN) Specifies the length of assignmentInfo including the NULL terminator.
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
NLSRemoveAssignment removes an assignment from a license certificate that was added with NLSAddAssignment. All information about the assignment you wish to
remove must be specified. This information can be obtained from the assignment list obtainable by calling NLSGetLicense. This function removes only one assignment from
the assignment list. To remove all assignments, call this function multiple times on all the installed assignments.
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.