IWMDRMDeviceApp::SynchronizeLicenses (deprecated)

banner art

This is preliminary documentation and subject to change.

This topic documents a feature of the Windows Media Device Manager SDK. We recommend that you migrate your application to use the Windows Portable Devices API. For more information, see the Windows Portable Devices SDK.

The SynchronizeLicenses method updates licenses on a device when they are close to expiring.

Syntax

HRESULT SynchronizeLicenses(
  IWMDMDevice*  pDevice,
  IWMDMProgress3*  pProgressCallback,
  DWORD  cMinCountThreshold,
  DWORD  cMinHoursThreshold
);

Parameters

pDevice

[in]  Pointer to an IWMDMDevice object.

pProgressCallback

[in]  Progress callback that will receive progress of any steps that it might need to carry out. The step is identified by the EventId parameter of the IWMDMProgress3 method called.

cMinCountThreshold

[in]  Optional minimum remaining play count on a device license.

cMinHoursThreshold

[in]  Optional minimum remaining hours on a device license.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
DRM_E_INVALIDARG One or more arguments are not valid.
DRM_E_INVALIDXMLTAG XML is improperly formed.
DRM_E_NOTIMPL This functionality is not currently implemented. (SyncLicenses w/pDevice=NULL)
DRM_E_NOXMLCLOSETAG The license XML was improperly formed.
DRM_E_NOXMLOPENTAG The license XML was improperly formed.
DRM_E_OUTOFMEMORY Out of memory.
DRM_E_XMLNOTFOUND Failed to find a required XML tag in the license.
NS_E_DEVICE_NOT_WMDRM_DEVICE The specified device is not a Windows Media DRM–compatible device.
NS_E_DRM_NEEDS_INDIVIDUALIZATION The DRM requires an individualized black box to perform this function. In other words, the Windows Media Format SDK requires a security upgrade.

Remarks

This call can only be made on a device that supports Windows Media DRM 10 for Portable Devices. You must specify at least one threshold parameter.

Requirements

Header: Requires both WMDRMDeviceApp.h and wmdrmdeviceapp_i.c (built from WMDRMDeviceApp.idl).

Library: mssachlp.lib

See Also