RcInitProxies Function

RcInitProxies Function

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Microsoft Exchange calls the RcInitProxies function so that the proxy address generation dynamic-link library (DLL) can perform any required initialization before Exchange calls the RcGenerateProxy Function with individual recipient objects.

Applies To

Proxy Generation DLL Entry Points

Syntax

[C++]RC RcInitProxies (     LPWSTR pszSiteProxy,     LPWSTR pszServer,     HANDLE* phProxySession );

Parameters

• pszSiteProxy
  Input parameter. The site proxy for this address type. May be null, if the address type supports that.
• pszServer
  Input parameter. A Unicode string containing the name of the server where the proxy generation DLL is being used.
• phProxySession
  Output parameter. Returns a handle to a proxy address generation session.

Return Value

Return Code, as defined in retcode.h. Exchange, recognizes only the following return codes.

RC_SUCCESS	Return this code to indicate success.
RC_IMPLEMENTATION	Return this code to indicate that proxies are not implemented for this address type. No proxy addresses will be stored. This status also implies that the RcGenerateProxy Function and CloseProxies Function entry points are not available, are NULL, or do not exist. This is not an error condition, and no error is reported to the user.
RC_MEMORY	Return this code to indicate that an error occurred while allocating memory.
RC_ERROR	Return this code to indicate some other error condition.

Remarks

The RcInitProxies function is used to make the site-specific information available to the RcGenerateProxy Function and RCValidateProxy Function.

The pszSiteProxy parameter is generally used as part of the recipient proxy address.

RcInitProxies allocates the memory for the phProxySession parameter. Your program must free this memory by calling the FreeProxy Function method.

Both pszSiteProxy and pszServer are guaranteed to stay valid until after the CloseProxies Function is called, so the DLL need only keep a copy of these pointers rather than copy the data.

The RcInitProxies function should not display any user interface, because proxy generation should be performed silently.

Test programs and other applications that use the proxy generation DLL can use the proxyinf.h, retcode.h, and proxygen.h header files that define proxy generation DLL interfaces, structures, and return codes.

Send us your feedback about the Microsoft Exchange Server 2003 SDK.

Build: June 2007 (2007.618.1)

© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.