<?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-AD6A057D-D514-4145-B7A6-E43959543E92" xml:lang="en"><title>HTTP

Proxy Property</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>By default, a new <codeph>RHTTPSession</codeph> is set to make direct connections

to an origin server. To switch it to use a proxy, the following two properties

must be set: <codeph>HTTP::EProxyUsage</codeph> and <codeph>HTTP::EProxyAddress</codeph>. </p>

<ul>

<li id="GUID-6E1C24B1-590B-5FFE-8C00-FDF030B22B19"><p> <codeph>HTTP::EProxyUsage</codeph> can

take the values <codeph>HTTP::EDoNotUseProxy</codeph> (the default) or <codeph>HTTP::EUseProxy</codeph>. </p> </li>

<li id="GUID-DDAE87A1-A5E8-53CD-A6C7-464066930AB8"><p> <codeph>HTTP::EProxyAddress</codeph> must

be set using an <xref href="GUID-B886F0AA-DB9C-356C-9B96-33252820F93E.dita"><apiname>RStringF</apiname></xref> value that contains the proxy

address as an IP Address and port number separated by a colon, for example,

"10.158.7.4:9003". </p> </li>

</ul>

<codeblock id="GUID-D7CF5B00-1F32-5424-8B81-1C1B53E4E6D7" xml:space="preserve">void CHttpClient::SetProxyL(RStringF aProxyAddr)

    {

    RHTTPConnectionInfo connInfo = iSess.ConnectionInfo();

    THTTPHdrVal proxyUsage(iSess.StringPool().StringF(HTTP::EUseProxy,RHTTPSession::GetTable()));

    connInfo.SetPropertyL(iSess.StringPool().StringF(HTTP::EProxyUsage,RHTTPSession::GetTable()), proxyUsage);

    THTTPHdrVal proxyAddr(aProxyAddr);

    connInfo.SetPropertyL(iSess.StringPool().StringF(HTTP::EProxyAddress,RHTTPSession::GetTable()), aProxyAddr);

    Printf(_L("Proxy set to:%S\n\n"), &iProxyName);

    }</codeblock>

<p>Changes made to the proxy settings will affect only new transactions opened

on the session, and not any currently in progress. </p>

<section id="GUID-AEA826D4-0F86-4817-8B06-BB0FA0799525"><title>Transaction proxy properties</title><p>A proxy setting can

be set for an individual transaction by setting the proxy properties on the

transaction. Proxy properties set on the transaction override any proxy properties

set on the session. </p></section>

</conbody></concept>