FileDrmRenewRights
This function renews the rights associated with FDRM-protected content.
HRESULT FileDrmRenewRights (
HWND hwndParent,
LPCTSTR pszFileName
);
Parameters
- hwndParent
[in] Handle to the window that owns any UI elements such as windows, dialog boxes, or message boxes displayed by this function. - pszFileName
[in] Path to the file that contains the FDRM-protected content.
Return Values
This function can return any HRESULT and the application should use the SUCCEEDED and FAILED macros to check the results. The following table shows additional HRESULTS values that may be returned.
| Value | Description |
|---|---|
| S_FDRM_NOPROVIDER | Success, but no FDRM provider found. |
| S_FDRM_NOTDRMOBJECT | Success, but the target is not a FDRM object. |
| E_FDRM_NOTALLOWED | Rights renewal is not allowed for this object type. |
Remarks
A rights renewal request is generated. This may cause a network connection to be opened.
This function allows an application to renew rights associated with FDRM-protected content. In most cases this will be handled by the FDRM provider when FileDrmHandleError is called. New or updated rights will arrive asynchronously.
Note When you use the FDRM APIs in a DSHOW filter, the FileDrmShowLicenseInfo function must not be called.
Requirements
Pocket PC: Windows Mobile Version 5.0 and later
Smartphone: Windows Mobile Version 5.0 and later
OS Versions: Windows CE 5.01 and later.
Header: FDRM.h.
Link Library: Aygshell.lib.
See Also
FDRM Functions | FDRM API Reference
Send Feedback on this topic to the authors