Symbian3/SDK/Source/GUID-2C7AF56F-F741-5C9B-83B9-46C175330ED1.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-2C7AF56F-F741-5C9B-83B9-46C175330ED1.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,29 @@
+<?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-2C7AF56F-F741-5C9B-83B9-46C175330ED1" xml:lang="en"><title>Safe
+data access</title><shortdesc>Describes how the parameters that are passed to the descriptors
+are checked to ensure the they are not accessing illegal data.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>The parameters that are passed to descriptor functions which access or
+operate on data, are checked to ensure that those operations are correctly
+specified and that no data outside the data area represented by the descriptor
+is accessed or changed.</p>
+<p>It is the programmer’s responsibility to ensure that all accesses to descriptor
+data are within bounds and that descriptors are sufficiently large to contain
+their data, either by making the original allocation large enough at program
+compile time or by dynamically allocating the descriptor at run-time.</p>
+<p>An illegal data access raises an exception, known as a panic, causing immediate
+program termination. In this event, it can be assumed that no illegal access
+of memory has taken place and that no data has been moved or damaged.</p>
+<p>The Format() function which operates on descriptor data is the only case
+where a program is offered the opportunity to handle a potential exception.</p>
+<section id="GUID-6C0DFCF4-2742-4F07-A161-A1A23879F99F"><title>See also</title> <p><xref href="GUID-445B19E5-E2EE-32E2-8D6C-C7D6A9B3C507.dita#GUID-445B19E5-E2EE-32E2-8D6C-C7D6A9B3C507/GUID-EE7DBF18-A16C-3983-924F-20C1907E7AAA"><apiname>TDes8::Format()</apiname></xref> </p> <p><xref href="GUID-C04A9A0C-DBA7-37DA-B744-54FBF3D544CD.dita#GUID-C04A9A0C-DBA7-37DA-B744-54FBF3D544CD/GUID-F3ED8A38-74C5-3C4D-AEAF-B405A0C5807D"><apiname>TDes16::Format()</apiname></xref> </p> </section>
+</conbody></concept>
\ No newline at end of file