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-770EF3C4-15D3-5A0F-B5DF-A95B27A0DB05" xml:lang="en"><title>How

    13 to Set Up an Outbound Proxy</title><shortdesc>This topic explains how to specify an outbound proxy server in

    14 the SIP Managed Profile. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <p>To specify an outbound proxy server, call <xref href="GUID-CDE67614-1A7A-3082-8D8D-71645668A0DE.dita#GUID-CDE67614-1A7A-3082-8D8D-71645668A0DE/GUID-901C0EE4-646C-351A-9E13-8972F2CBAC8F"><apiname>CSIPManagedProfile::SetParameter()</apiname></xref> with

    16 the <xref href="GUID-51E1043D-5FC6-3A79-911B-816CE8043A25.dita"><apiname>KSIPOutboundProxy</apiname></xref> parameter and an IP address. </p>

    17 <p>You can also let the stack automatically discover the proxy address by

    18 setting <xref href="GUID-A46F476F-40D1-3893-952F-8E958132653F.dita"><apiname>KSIPResolveProxy</apiname></xref> to <codeph>ETrue</codeph>. </p>

    19 <ul>

    20 <li id="GUID-09F02A7F-11D3-513B-8182-CB052CB0C5AB"><p>By default or if <xref href="GUID-A46F476F-40D1-3893-952F-8E958132653F.dita"><apiname>KSIPResolveProxy</apiname></xref> is

    21 set to <codeph>EFalse</codeph>, <xref href="GUID-51E1043D-5FC6-3A79-911B-816CE8043A25.dita"><apiname>KSIPOutboundProxy</apiname></xref> sets

    22 the IP address of the outbound proxy. If the proxy server cannot be found,

    23 the profile enabling fails. </p> </li>

    24 <li id="GUID-A9051F50-43D7-549C-87EC-175F12661642"><p>If <xref href="GUID-A46F476F-40D1-3893-952F-8E958132653F.dita"><apiname>KSIPResolveProxy</apiname></xref> is

    25 set to <codeph>ETrue</codeph>, <xref href="GUID-51E1043D-5FC6-3A79-911B-816CE8043A25.dita"><apiname>KSIPOutboundProxy</apiname></xref> sets the

    26 backup IP address for the outbound proxy. The SIP stack attempts to find the

    27 proxy through a DHCP request and only uses the backup address if the proxy

    28 discovery process fails. </p> </li>

    29 </ul>

    30 <p>Backwards compatibility note: <codeph>"sip:0.0.0.0"</codeph> is a valid

    31 value for <codeph>KSIPOutboundProxy</codeph>. It is equivalent to requesting

    32 DCHP discovery without specifying a backup address. </p>

    33 </conbody></concept>