IWMDRMDeviceApp::SynchronizeLicenses method
The SynchronizeLicenses method updates licenses on a device when they are close to expiring.
Syntax
HRESULT SynchronizeLicenses(
[in] IWMDMDevice *pDevice,
[in] IWMDMProgress3 *pProgressCallback,
[in] DWORD cMinCountThreshold,
[in] 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 value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
One or more arguments are not valid. |
|
XML is improperly formed. |
|
This functionality is not currently implemented. (SyncLicenses w/ pDevice =NULL) |
|
The license XML was improperly formed. |
|
The license XML was improperly formed. |
|
Out of memory. |
|
Failed to find a required XML tag in the license. |
|
The specified device is not a Windows Media DRM-compatible device. |
|
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
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|