1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-EFAEDFA5-3807-56EB-8D47-3A6960C4056C" xml:lang="en"><title>How

    13 to use the SDP Codec API</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <section id="GUID-36C9040A-BE35-5DAD-8D32-089C45AD6A6C"><title>Protocols</title> <p>The

    15 following steps describe how to use the SDP Codec API to create an SDP description: </p> <ul>

    16 <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

    17 and open the string pool before use. <b>Note</b>: The string table includes

    18 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

    19 called. The string table includes all predefined SDP related constants. </p> </li>

    20 <li id="GUID-5865EC55-8737-50C3-8E3A-59E2864A2FB9"><p>The net type and the

    21 address type of the connection and origin field parameters that are predefined

    22 are retrieved from the string pool. </p> </li>

    23 <li id="GUID-8CA935E5-00A8-5B8C-8615-F1045657AEA5"><p>Create the origin field

    24 with origin field parameters, and set the <xref href="GUID-FF6D4EAD-3AAE-3843-8A9C-7C92426FC29F.dita"><apiname>CSdpDocument</apiname></xref> object. </p> </li>

    25 <li id="GUID-F54C71B1-F53F-51B5-BC34-47250D11B2FE"><p>Create the connection

    26 field from the connection parameters, and set the <xref href="GUID-FF6D4EAD-3AAE-3843-8A9C-7C92426FC29F.dita"><apiname>CSdpDocument</apiname></xref> object. </p> </li>

    27 <li id="GUID-96FCCAE1-4DE2-5113-BA06-D5486621F809"><p>When you finish with

    28 the SDP description, delete the <xref href="GUID-FF6D4EAD-3AAE-3843-8A9C-7C92426FC29F.dita"><apiname>CSdpDocument</apiname></xref> object and

    29 close the string pool. </p> </li>

    30 </ul> <p>The following illustration shows how to create an SDP description. </p> <fig id="GUID-FB29EDEC-BD06-5571-BDCE-A6E8A9A94613">

    31 <image href="GUID-55754EF4-EC25-5CE3-9B38-79F278BCF19F_d0e343167_href.png" placement="inline"/>

    32 </fig> <p> <b>Note</b>: In the following illustration only required SDP fields

    33 are included. </p> </section>

    34 <section id="GUID-0C86D6D3-2EDD-54B8-A2FE-E68CF43D40E8"><title>Error handling</title> <p>All

    35 function calls are synchronous. When an error occurs the functions leave with

    36 SDP Codec specific error codes and Symbian platform error codes. </p> </section>

    37 </conbody></concept>