Microsoft KB Archive/898835

= MAPI properties for RPC over HTTP settings in Outlook 2003 =

Article ID: 898835

Article Last Modified on 5/5/2005

-

APPLIES TO


 * Microsoft Office Outlook 2003

-





INTRODUCTION
Microsoft Office Outlook 2003 uses remote procedure call (RPC) over HyperText Transfer Protocol (HTTP) to connect to Microsoft Exchange Server 2003.

This article describes the MAPI properties that you can use to configure RPC over HTTP settings to enable Outlook 2003 to connect to Exchange Server 2003.



MORE INFORMATION
Note The following MAPI properties are stored in the MAPI Global Profile Section. // New MAPI properties for RPC over HTTP

// This is the main bitmask that holds most of the settings.
 * 1) define PR_ROH_FLAGS               PROP_TAG(PT_LONG,0x6623)

// This is the string for &quot;Use this URL to connect to my proxy server for Exchange&quot;.
 * 1) define PR_ROH_PROXY_SERVER        PROP_TAG(PT_UNICODE,0x6622)

// This is the string for &quot;Principal name for proxy server&quot;.
 * 1) define PR_ROH_PROXY_PRINCIPAL_NAME PROP_TAG(PT_UNICODE,0x6625)

// This is the property for the Basic or NTLM authentication method.
 * 1) define PR_ROH_PROXY_AUTH_SCHEME   PROP_TAG(PT_LONG,0x6627)

// Flags that are used in PR_ROH_FLAGS

// Connect to my Exchange mailbox by using HTTP.
 * 1) define ROHFLAGS_USE_ROH               0x1

// Connect by using SSL only.
 * 1) define ROHFLAGS_SSL_ONLY              0x2

// Mutually authenticate the session when connecting by using SSL.
 * 1) define ROHFLAGS_MUTUAL_AUTH           0x4

// On fast networks, connect by using HTTP first. Then, connect by using TCP/IP.
 * 1) define ROHFLAGS_HTTP_FIRST_ON_FAST    0x8

// On slow networks, connect by using HTTP first. Then, connect by using TCP/IP.
 * 1) define ROHFLAGS_HTTP_FIRST_ON_SLOW    0x20

// Values that are used in PR_ROH_PROXY_AUTH_SCHEME

// Basic authentication
 * 1) define ROHAUTH_BASIC                  0x1

// NTLM authentication The following list provides more information about these properties and their settings.
 * 1) define ROHAUTH_NTLM                   0x2
 * The PR_ROH_FLAGS property is a bitmask that is made up of one or more of the values that appear in the previous list. This property may contain multiple values.

To set the PR_ROH_FLAGS property to turn on RPC over HTTP, to require SSL, and to specify that the HTTP protocol should be used first on slow connections, set the values of the PR_ROH_FLAGS property to PR_ROH_FLAGS ROHFLAGS_USE_ROH | ROHFLAGS_USE_SSL_ONLY | ROHFLAGS_HTTP_FIRST_ON_SLOW (= 0x23).
 * The PR_ROH_PROXY_SERVER property contains the URL of the proxy server that is used to connect Outlook 2003 to Exchange Server 2003 without the HTTP protocol or the HyperText Transfer Protocol Secure (HTTPS) protocol that comes before the URL.

To set the PR_ROH_PROXY_SERVER property to connect Outlook 2003 to Exchange Server 2003 without the HTTP protocol or the HTTPS protocol that comes before the URL, set the values of the PR_RO_PROXY_SERVER property to PR_RO_PROXY_SERVER.
 * The PR_ROH_PROXY_PRINCIPAL_NAME property contains the principal name of the proxy server.
 * The PR_ROH_PROXY_AUTH_SCHEME property can be set for either Basic authentication or NTLM authentication.

To set the PR_ROH_PROXY_AUTH_SCHEME property for Basic authentication, set the values of the PR_ROH_PROXY_AUTH_SCHEME property to PR_ROH_PROXY_ROHAUTH_BASIC.

To set the PR_ROH_PROXY_AUTH_SCHEME property for NTLM authentication, set the values of the PR_ROH_PROXY_AUTH_SCHEME property to PR_ROH_PROXY_ROHAUTH_NTLM.

