This topic has not yet been rated - Rate this topic

FileDrmRenewRights

Windows Mobile 6.5

4/8/2010

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 Value

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

Header	fdrm.h
Library	aygshell.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

Reference

FDRM Functions
FDRM API Reference

Concepts

Using FDRM APIs in DSHOW Filters

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD