IpcSetLicenseProperty function

Sets license properties for the platform.

Syntax

HRESULT WINAPI IpcSetLicenseProperty(
  _In_     IPC_LICENSE_HANDLE hLicense,
           BOOL               fDelete,
           DWORD              dwPropID,
  _In_opt_ LPCVOID            pvProperty
);

Parameters

hLicense [in]

A handle to the license to be modified.

fDelete

Set to TRUE to delete the existing information in the license. When set to TRUE; pvProperty is ignored.

Set to FALSE to replace the license info for the property specified by dwPropId with the value specified by pvProperty; pvProperty cannot be NULL.

dwPropID

The ID of the license property to modify. The data specified by pvProperty must match this type. For a list of valid property IDs, see License property types.

pvProperty [in, optional]

A pointer to the license information data to be written. If fDelete is false, this parameter cannot be NULL. The structure of the data depends on the property ID specified in dwPropID. For more information, see License property types.

Return value

If the function succeeds, the return value is S_OK. If the function fails, it returns an HRESULT value that indicates the error.

For more information, see Error codes for a description of all RMS SDK 2.1 return values.

Possible values include, but are not limited to, those in the following list.

E_INVALIDARGS

Meaning: The fDelete parameter is TRUE, but the license property specified by the dwPropID parameter is not a property that can be deleted with this function. For more information about which properties cannot be deleted with IpcSetLicenseProperty, see License property types.

Action: Do not try to delete the specified property with this function.

Requirements

Minimum supported client
Windows Vista with SP2
Minimum supported server
Windows Server 2008
Header
Ipcprot.h (include Msipc.h)
Library
Msipc.lib
DLL
Msipc.dll

See also

IpcGetLicenseProperty

IpcSerializeLicense

License property types

Error codes