NLSTransferOwnership(3nw)


NLSTransferOwnership -- transfers the ownership of a license certificate

Synopsis

   LS_STATUS_CODE NLSTransferOwnership( 
      LS_STR          *licenseSystem, 
      LS_STR          *publisher, 
      LS_STR          *product, 
      LS_STR          *version, 
      LS_LICENSE_ID    licenseID, 
      LS_STR          *newOwner); 

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 to transfer ownership.

newOwner
(IN) Points to the DN of the new owner of the license certificate.

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
The specified license certificate could not be located, or you do not have privileges to delete this license certificate.

Notices

NLSTransferOwnership transfers the ownership of the license certificate from its current value to the DN passed in through the newOwner parameter. Only users with a security equivalency to this new DN are able to add, modify, or remove assignments and delete the license certificate.

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.