--- a/Symbian3/PDK/Source/GUID-A36B7C77-F0F7-599A-83BC-26B4A80496BD.dita Fri Jun 11 12:39:03 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-A36B7C77-F0F7-599A-83BC-26B4A80496BD.dita Fri Jun 11 15:24:34 2010 +0100
@@ -1,118 +1,118 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
-<!-- This component and the accompanying materials are made available under the terms of the License
-"Eclipse Public License v1.0" which accompanies this distribution,
-and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
-<!-- Initial Contributors:
- Nokia Corporation - initial contribution.
-Contributors:
--->
-<!DOCTYPE concept
- PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
-<concept id="GUID-A36B7C77-F0F7-599A-83BC-26B4A80496BD" xml:lang="en"><title>MIME
-Content Policy</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p>MIME Content Policy API is used for checking the MIME types and file extensions
-against the Closed Content List (<codeph>apfmimecontentpolicy.rss</codeph>).
-It also provides the functionality for checking if a given file is a DRM envelope,
-and a function to check if a file is considered closed content for any reason. </p>
-<section><title>Description</title> <p>MIME Content Policy utility
-uses File Server to access the resource files and Application Architecture
-Server (apparc) for recognizing and checking the MIME type using Symbian recognizers. </p> <p>This
-utility uses Content Access Framework to check whether a file is forward locked,
-superdistributable or a DRM envelope. </p> <p>All functionality can be accessed
-via a <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>CApfMimeContentPolicy</apiname></xref> instance. </p> <p>The
-functionality of this utility can be accessed through the <codeph>apfmimecontentpolicy.h</codeph> interface
-header. The binaries are linked to <codeph>Apfile.DLL</codeph>. </p> <p>The
-diagram below illustrates the key relationships between the MIME Content Policy
-utility and the other subsystems: </p> <fig id="GUID-C81CE8AB-E02D-5D7D-931F-9FC5D3A26F3D">
-<title> Class diagram of the MIME Content Policy </title>
-<image href="GUID-E08D9F14-F50A-56C7-9D95-9306E540A02C_d0e171987_href.png" placement="inline"/>
-</fig> <table id="GUID-AFE0184C-15E9-508D-A98A-988F3BAD5E3B">
-<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
-<thead>
-<row>
-<entry><p><b>Class</b></p></entry>
-<entry><p><b>Description</b></p></entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry><p> <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>CApfMimeContentPolicy</apiname></xref> </p> </entry>
-<entry><p>An interface class for the MIME Content Policy component. All the
-calls are routed to the <codeph>CApfMimeContentPolicyImpl</codeph> class without
-further processing here. </p> </entry>
-</row>
-<row>
-<entry><p> <codeph>CApfMimeContentPolicyImpl</codeph> </p> </entry>
-<entry><p>Implements the MIME Content Policy functionality. </p> </entry>
-</row>
-<row>
-<entry><p> <codeph>CContent</codeph> </p> </entry>
-<entry><p>A Symbian class for browsing the content objects contained within
-a single file. </p> </entry>
-</row>
-<row>
-<entry><p> <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>RResourceFile</apiname></xref> </p> </entry>
-<entry><p>A Symbian class for accessing the resource file. </p> </entry>
-</row>
-<row>
-<entry><p> <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>RFs</apiname></xref> </p> </entry>
-<entry><p>A Symbian class for a file system session. </p> </entry>
-</row>
-<row>
-<entry><p> <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>RApaLsSession</apiname></xref> </p> </entry>
-<entry><p>A Symbian class for an Application Architecture Server session.
-Needed for recognizing the MIME type of a file. </p> </entry>
-</row>
-</tbody>
-</tgroup>
-</table> <p><b>Usage</b> </p> <p>A <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>CApfMimeContentPolicy</apiname></xref> instance
-is created using one of its exported factory methods, <codeph>NewL()</codeph> or <codeph>NewLC()</codeph>.
-The exported interface can then be used in the usual way via the created instance.
-After the usage, the instance must be cleaned up using either <codeph>PopAndDestroy()</codeph> or <codeph>delete</codeph>. </p> <p>This
-utility uses the common Symbian platform error handling mechanisms and has
-no specific errors defined. </p> </section>
-<section><title>Example</title> <p>An example of code explaining the usage
-of MIME Content Policy API is given below: </p> <codeblock id="GUID-47E582CB-B4CF-5EC7-A328-3E22E864167A" xml:space="preserve">#include <apfmimecontentpolicy.h>
-#include <apgcli.h> // RApaLsSession
-
-RApaLsSession aLs;
-TFileName fileName = <name of the file to be checked>
-TUid uid;
-TDataType recData;
-
-CApfMimeContentPolicy *ccp = CApfMimeContentPolicy::NewLC();
-
-if (ccp->IsDRMEnvelope( fileName ))
- {
- // Whatever needs to be done if file is DRM envelope.
- }
-
-// Check file extension.
-TParse parser;
-parser.Set(fileName, NULL, NULL);
-if (ccp->IsClosedExtension(parser.Ext()))
- {
- // Do what needs to be done if closed content.
- }
-
-aLs.Connect(); // Open session with Application Architecture Server
-aLs.AppForDocument(fileName, uid, recData); // Get MIME type for file.
-
-// Check if this MIME type is closed.
-if (ccp->IsClosedType(recData.Des())
- {
- // Whatever needs to be done if type is closed.
- }
-
-// Check if file is closed for any reason:
-if (ccp->IsClosedFileL( fileName );
- {
- // Do whatever has to be done if file is closed.
- }
-
-// Don't forget to clean up.
-CleanupStack::PopAndDestroy(); // ccp
-</codeblock> <p>For more information on individual methods, see the reference
-API for <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>CApfMimeContentPolicy</apiname></xref>. </p> </section>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License
+"Eclipse Public License v1.0" which accompanies this distribution,
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+ Nokia Corporation - initial contribution.
+Contributors:
+-->
+<!DOCTYPE concept
+ PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-A36B7C77-F0F7-599A-83BC-26B4A80496BD" xml:lang="en"><title>MIME
+Content Policy</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>MIME Content Policy API is used for checking the MIME types and file extensions
+against the Closed Content List (<codeph>apfmimecontentpolicy.rss</codeph>).
+It also provides the functionality for checking if a given file is a DRM envelope,
+and a function to check if a file is considered closed content for any reason. </p>
+<section><title>Description</title> <p>MIME Content Policy utility
+uses File Server to access the resource files and Application Architecture
+Server (apparc) for recognizing and checking the MIME type using Symbian recognizers. </p> <p>This
+utility uses Content Access Framework to check whether a file is forward locked,
+superdistributable or a DRM envelope. </p> <p>All functionality can be accessed
+via a <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>CApfMimeContentPolicy</apiname></xref> instance. </p> <p>The
+functionality of this utility can be accessed through the <codeph>apfmimecontentpolicy.h</codeph> interface
+header. The binaries are linked to <codeph>Apfile.DLL</codeph>. </p> <p>The
+diagram below illustrates the key relationships between the MIME Content Policy
+utility and the other subsystems: </p> <fig id="GUID-C81CE8AB-E02D-5D7D-931F-9FC5D3A26F3D">
+<title> Class diagram of the MIME Content Policy </title>
+<image href="GUID-E08D9F14-F50A-56C7-9D95-9306E540A02C_d0e167315_href.png" placement="inline"/>
+</fig> <table id="GUID-AFE0184C-15E9-508D-A98A-988F3BAD5E3B">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<thead>
+<row>
+<entry><p><b>Class</b></p></entry>
+<entry><p><b>Description</b></p></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p> <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>CApfMimeContentPolicy</apiname></xref> </p> </entry>
+<entry><p>An interface class for the MIME Content Policy component. All the
+calls are routed to the <codeph>CApfMimeContentPolicyImpl</codeph> class without
+further processing here. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>CApfMimeContentPolicyImpl</codeph> </p> </entry>
+<entry><p>Implements the MIME Content Policy functionality. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>CContent</codeph> </p> </entry>
+<entry><p>A Symbian class for browsing the content objects contained within
+a single file. </p> </entry>
+</row>
+<row>
+<entry><p> <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>RResourceFile</apiname></xref> </p> </entry>
+<entry><p>A Symbian class for accessing the resource file. </p> </entry>
+</row>
+<row>
+<entry><p> <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>RFs</apiname></xref> </p> </entry>
+<entry><p>A Symbian class for a file system session. </p> </entry>
+</row>
+<row>
+<entry><p> <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>RApaLsSession</apiname></xref> </p> </entry>
+<entry><p>A Symbian class for an Application Architecture Server session.
+Needed for recognizing the MIME type of a file. </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> <p><b>Usage</b> </p> <p>A <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>CApfMimeContentPolicy</apiname></xref> instance
+is created using one of its exported factory methods, <codeph>NewL()</codeph> or <codeph>NewLC()</codeph>.
+The exported interface can then be used in the usual way via the created instance.
+After the usage, the instance must be cleaned up using either <codeph>PopAndDestroy()</codeph> or <codeph>delete</codeph>. </p> <p>This
+utility uses the common Symbian platform error handling mechanisms and has
+no specific errors defined. </p> </section>
+<section><title>Example</title> <p>An example of code explaining the usage
+of MIME Content Policy API is given below: </p> <codeblock id="GUID-47E582CB-B4CF-5EC7-A328-3E22E864167A" xml:space="preserve">#include <apfmimecontentpolicy.h>
+#include <apgcli.h> // RApaLsSession
+
+RApaLsSession aLs;
+TFileName fileName = <name of the file to be checked>
+TUid uid;
+TDataType recData;
+
+CApfMimeContentPolicy *ccp = CApfMimeContentPolicy::NewLC();
+
+if (ccp->IsDRMEnvelope( fileName ))
+ {
+ // Whatever needs to be done if file is DRM envelope.
+ }
+
+// Check file extension.
+TParse parser;
+parser.Set(fileName, NULL, NULL);
+if (ccp->IsClosedExtension(parser.Ext()))
+ {
+ // Do what needs to be done if closed content.
+ }
+
+aLs.Connect(); // Open session with Application Architecture Server
+aLs.AppForDocument(fileName, uid, recData); // Get MIME type for file.
+
+// Check if this MIME type is closed.
+if (ccp->IsClosedType(recData.Des())
+ {
+ // Whatever needs to be done if type is closed.
+ }
+
+// Check if file is closed for any reason:
+if (ccp->IsClosedFileL( fileName );
+ {
+ // Do whatever has to be done if file is closed.
+ }
+
+// Don't forget to clean up.
+CleanupStack::PopAndDestroy(); // ccp
+</codeblock> <p>For more information on individual methods, see the reference
+API for <xref href="GUID-9C1A6E56-5017-355C-B246-2B9CA7DA0D1B.dita"><apiname>CApfMimeContentPolicy</apiname></xref>. </p> </section>
</conbody></concept>
\ No newline at end of file