DRM Files

Article
08/28/2006

This code sample is named FileDRM. It demonstrates how to use the FDRM API, which allow applications to use Digital Rights Management (DRM) protected content. The application displays DRM protected JPEG images.

Feature Area

File-Based Digital Rights Management

Relevant APIs

Usage

To run the code sample

Navigate to the solution file (*.sln), and double-click it. By default, the solution files are copied to the following folders:

C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Pocket PC SDK\Samples\CPP\Win32\Filedrm\``FileDRM.sln

C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Smartphone SDK\Samples\CPP\Win32\Filedrm\``FileDRM.sln

Microsoft Visual Studio 2005 launches and loads the solution.
Build the solution (Ctrl+Shift+B).
Deploy the solution (F5).

To use the application

Using your mobile device's phone, download at least one DRM protected JPEG image.

The basic rules for using DRM content

1. Call FileDrmVerifyRights before attempting to open the content to ensure that you will be able to use the content.

2. Use FileDrmCreateFile instead of CreateFile to open the content.

In this code sample, the routine CImageView::OpenImageFile demonstrates steps 1 and 2.

3. Once the content has been "used," call FileDrmCommitRights.

In this code sample, the routine CImageView::Draw demonstrates step 3.

Remarks

To use this application, you must have a mobile device designed to work with DRM content.

FileDrmCommitRights is called only after the image has been successfully displayed. This is important for content where the number of times that the content can be used is restricted. This routine also demonstrates how to handle content that might have restrictions on how long it can be used.

The FDRM APIs also work with non-protected content.

Requirements

Pocket PC SDK: Windows Mobile 5.0 Pocket PC SDK.
Smartphone SDK: Windows Mobile 5.0 Smartphone SDK.
Development Environment: Visual Studio 2005.
ActiveSync: Version 4.0.