Name

license, legal.license, kPMRPCLegalLicense — Set the licence details.

Synopsis

void legal.license( name,
organisation,
code);
name : string, length 1..255;
organisation : string, default, length 1..255;
code : string, length 1..255;

Description

Set the licence details.

license applies the provided licence details to engine. All parameters are case sensitive and must be provided exactly as provided in the issued licence details.

The engine can work with multiple licence details. A single licence may encapsulate a single feature or user right.

Parameters

name. Name provided in the licence details. name is a string. name must be between 1 and 255 characters long, inclusive.

organisation. Organisation provided in the licence details. organisation is a string. If organisation is omitted, the default Personal is used. organisation must be between 1 and 255 characters long, inclusive.

code. Code provided in the licence details. code is a string. code must be between 1 and 255 characters long, inclusive.

Security

license can be requested by any authenticated client.

Unauthenticated clients are authorized using the uk.co.dssw.powermanager.legal.license right. By default, only local processes belonging to administrator can send a license request.

Availablility

pmdctl

Examples

Example 63. C: Minimal legal.license

CFStringRef myCode = NULL;
CFStringRef myName = NULL;

...
CFMutableDictionaryRef myRequest = PMRequestCreateWithParameters(kCFAllocatorDefault, kPMRPCLegalLicense, kPMRPCParameterCode, myCode, kPMRPCParameterName, myName, nil);