IWMDRMDeviceApp::SynchronizeLicenses (deprecated)
![]() |
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
.gif)