Symbian3/SDK/Source/GUID-EFAEDFA5-3807-56EB-8D47-3A6960C4056C.dita
author Graeme Price <GRAEME.PRICE@NOKIA.COM>
Fri, 15 Oct 2010 14:32:18 +0100
changeset 15 307f4279f433
parent 13 48780e181b38
permissions -rw-r--r--
Initial contribution of the Adaptation Documentation.

<?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-EFAEDFA5-3807-56EB-8D47-3A6960C4056C" xml:lang="en"><title>How
to use the SDP Codec API</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-36C9040A-BE35-5DAD-8D32-089C45AD6A6C"><title>Protocols</title> <p>The
following steps describe how to use the SDP Codec API to create an SDP description: </p> <ul>
<li id="GUID-E54E7175-023E-57B7-867C-C7B2132DC1F4"><p>Create a <xref href="GUID-FF6D4EAD-3AAE-3843-8A9C-7C92426FC29F.dita"><apiname>CSdpDocument</apiname></xref> object
and open the string pool before use. <b>Note</b>: The string table includes
predefined SDP constants for which handles are retrieved when <xref href="GUID-6841DB3A-C481-34D0-9428-236CCC316BBD.dita#GUID-6841DB3A-C481-34D0-9428-236CCC316BBD/GUID-82ABB289-BADC-33C7-B950-3FFAF50B48F1"><apiname>SdpCodecStringPool::StringPoolL()</apiname></xref> is
called. The string table includes all predefined SDP related constants. </p> </li>
<li id="GUID-5865EC55-8737-50C3-8E3A-59E2864A2FB9"><p>The net type and the
address type of the connection and origin field parameters that are predefined
are retrieved from the string pool. </p> </li>
<li id="GUID-8CA935E5-00A8-5B8C-8615-F1045657AEA5"><p>Create the origin field
with origin field parameters, and set the <xref href="GUID-FF6D4EAD-3AAE-3843-8A9C-7C92426FC29F.dita"><apiname>CSdpDocument</apiname></xref> object. </p> </li>
<li id="GUID-F54C71B1-F53F-51B5-BC34-47250D11B2FE"><p>Create the connection
field from the connection parameters, and set the <xref href="GUID-FF6D4EAD-3AAE-3843-8A9C-7C92426FC29F.dita"><apiname>CSdpDocument</apiname></xref> object. </p> </li>
<li id="GUID-96FCCAE1-4DE2-5113-BA06-D5486621F809"><p>When you finish with
the SDP description, delete the <xref href="GUID-FF6D4EAD-3AAE-3843-8A9C-7C92426FC29F.dita"><apiname>CSdpDocument</apiname></xref> object and
close the string pool. </p> </li>
</ul> <p>The following illustration shows how to create an SDP description. </p> <fig id="GUID-FB29EDEC-BD06-5571-BDCE-A6E8A9A94613">
<image href="GUID-55754EF4-EC25-5CE3-9B38-79F278BCF19F_d0e343436_href.png" placement="inline"/>
</fig> <p> <b>Note</b>: In the following illustration only required SDP fields
are included. </p> </section>
<section id="GUID-0C86D6D3-2EDD-54B8-A2FE-E68CF43D40E8"><title>Error handling</title> <p>All
function calls are synchronous. When an error occurs the functions leave with
SDP Codec specific error codes and Symbian platform error codes. </p> </section>
</conbody></concept>