FileDrmCreateForwardableContent

4/8/2010

This function creates a file that contain FDRM-protected content so that the file can be sent to another device.

Syntax

HRESULT FileDrmCreateForwardableContent (
  LPCTSTR pszFileName,
  DWORD dwFlags,
  LPCTSTR pszOutputFile
);

Parameters

  • pszFileName
    [in] The fully qualified path to the file to be forwarded.
  • dwFlags
    [in] Flags to control the format of the generated document. The following table shows the possible values for dwFlags.

    Flag Value Description

    FDRCF_BARE

    0x00000001

    Bare file. Content with no MIME header.

    FDRCF_MIMEENCODED

    0x00000002

    Add needed MIME headers.

  • pszOutputFile
    [in] The fully qualified path for a file to hold the document.

Return Values:

The function may 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

E_FDRM_NOPROVIDER

No provider found.

E_FDRM_NOTDRMOBJECT

The target is not an FDRM object.

E_FDRM_NOFORWARDRIGHTS

You do not possess forwarding rights.

Remarks

A new file is created that holds the FDRM-protected content. Applications can use this function to package format in such a way that it can be sent to another device.

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

See Also

Reference

FDRM API Reference
FDRM Functions