Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

This function shows the rights associated with FDRM-protected content.

Syntax 

HRESULT FileDrmShowLicenseInfo (
  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] The path of the file for which license information is shown.

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 HRESULT 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.

Remarks

A dialog is displayed showing the rights associated with the file. This function returns when the user dismisses the dialog.

Note:
When you use the FDRM APIs in a DSHOW filter the FileDrmShowLicenseInfofunction must not be called.

Requirements

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

See Also