RcInitProxies

The RcInitProxies function invokes the proxy generation DLL to perform any initialization required before calling the RcGenerateProxy function with individual recipient objects.

Quick Info

RC RcInitProxies(
  LPWSTR pszDomainProxy,  
  LPWSTR pszServer,       
  HANDLE * phProxySession  
);
 

Parameters

pszDomainProxy

Input parameter. A Unicode string containing the site proxy address for this address-type. Cannot be NULL.

pszServer

Input parameter. A Unicode string containing the name of the server where the proxy generation DLL is being used.

phProxySession

Output parameter. Handle to a proxy address generation session.

Return Values

See Return Values.

If RcInitProxies returns RC_IMPLEMENTATION, proxy addresses are not implemented for this address type. In this case, no proxy addresses are stored and the RcGenerateProxy and CloseProxies entry points to this DLL are undefined. However, users do not see an error because pszSiteProxy == NULL is a supported configuration.

Remarks

The RcInitProxies function is only used to make the site specific information accessible to the RcGenerateProxy and RcValidateProxy functions.

The pszDomainProxy 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.

Both pszDomainProxy and pszServer are guaranteed to stay valid until after CloseProxies is called, so the DLL need only keep a copy of these pointers rather than copy the data. Or, the DLL can copy the data with the same result, as the information these structures point to will not change until after CloseProxies is called.

For more information on this function, see Proxy Generation DLL Entry Points.

See Also

CloseProxies, RcGenerateProxy, RcValidateProxy