MAPI properties for RPC over HTTP settings in Outlook 2003 (898835)



The information in this article 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.
#define PR_ROH_FLAGS                PROP_TAG(PT_LONG,0x6623)

// This is the string for "Use this URL to connect to my proxy server for Exchange".
#define PR_ROH_PROXY_SERVER         PROP_TAG(PT_UNICODE,0x6622)

// This is the string for "Principal name for proxy server".
#define PR_ROH_PROXY_PRINCIPAL_NAME PROP_TAG(PT_UNICODE,0x6625)

// This is the property for the Basic or NTLM authentication method.
#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.
#define ROHFLAGS_USE_ROH                0x1

// Connect by using SSL only.
#define ROHFLAGS_SSL_ONLY               0x2

// Mutually authenticate the session when connecting by using SSL.
#define ROHFLAGS_MUTUAL_AUTH            0x4

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

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

// Values that are used in PR_ROH_PROXY_AUTH_SCHEME

// Basic authentication
#define ROHAUTH_BASIC                   0x1

// NTLM authentication
#define ROHAUTH_NTLM                    0x2
The following list provides more information about these properties and their settings.
  • 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.

REFERENCES

For more information about the RPC over HTTP feature of Outlook 2003, click the following article number to view the article in the Microsoft Knowledge Base:

831050 Description of the configuration options for the Exchange over the Internet feature in Outlook 2003

For more information about opening the MAPI Global Profile Section, click the following article number to view the article in the Microsoft Knowledge Base:

188482 How to open the Global Profile Section


Modification Type:MinorLast Reviewed:5/5/2005
Keywords:kbinfo KB898835 kbAudDeveloper