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.
[C++]RC RcInitProxies ( LPWSTR pszSiteProxy, LPWSTR pszServer, HANDLE* phProxySession );
- Input parameter. The site proxy for this address type. May be null, if the address type supports that.
- Input parameter. A Unicode string containing the name of the server where the proxy generation DLL is being used.
- Output parameter. Returns a handle to a proxy address generation session.
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.
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.