Share via


IpcCreateLicenseMetadataHandle function

Creates a handle for create or modify operations on the metadata of the serialized license.

Syntax

HRESULT WINAPI IpcCreateLicenseMetadataHandle(
  _In_       PCIPC_BUFFER         pvSerializedLicense,
             IPC_KEY_HANDLE       hKey,
  _Reserved_ LPVOID               pvReserved,
  _Out_      PIPC_METADATA_HANDLE phMetadata
);

Parameters

pvSerializedLicense [in]

Pointer to the serialized license with or without the metadata information set.

hKey

Handle to a key object acquired via IpcGetKey or via IpcGetSerializedLicense.

pvReserved

This is a reserved field and must be NULL.

phMetadata [out]

The resulting handle.

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_INVALIDARG

Remarks

The user must be the owner of the PL to be able to modify the metadata.

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

License metadata property types

Notification preference

Notification type

IpcCreateLicenseMetadataHandle

IpcSetLicenseMetadataProperty

IpcSerializeLicenseWithMetadata

IpcfEncryptFileWithMetadata

IpcfEncryptFileStreamWithMetadata

IpcRegisterLicense