Export (0) Print
Expand All

IpcCreateLicenseFromScratch function

Returns a handle to a license created from scratch. The license can be edited by calling IpcSetLicenseProperty.

Syntax


HRESULT WINAPI IpcCreateLicenseFromScratch(
  _In_       PCIPC_TEMPLATE_ISSUER pTemplateIssuer,
             DWORD                 dwFlags,
  _Reserved_ LPVOID                pvReserved,
  _Out_      PIPC_LICENSE_HANDLE   phLicense
);

Parameters

pTemplateIssuer [in]

A pointer to a IPC_TEMPLATE_ISSUER structure returned by a call to IpcGetTemplateIssuerList.

The license created will be protected to the AD RMS server pointed to by the connectionInfo member of this IPC_TEMPLATE_ISSUER structure.

dwFlags

Must be 0.

pvReserved

This parameter is reserved and must be NULL.

phLicense [out]

A pointer to a variable that receives a handle to the created license.

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.

Remarks

When you have finished using the license handle created with this function, close it by using the IpcCloseHandle 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

IPC_TEMPLATE_ISSUER
IpcGetLicenseProperty
IpcGetTemplateIssuerList
IpcSerializeLicense
IpcSetLicenseProperty
Error codes

 

 

Show:
© 2015 Microsoft