Proxy Generation DLL Entry Points

Topic Last Modified: 2006-06-14

A proxy generation dynamic-link library (DLL) creates and validates recipient addresses so that the remote mail system will accept and correctly deliver messages intended for recipients in that system.

The following table lists the entry points that proxy generation DLLs must implement.

Function	Action	When called
RcInitProxies Function	Initializes a new proxy address generation session.	Before recipient objects or address types are created.
RcGenerateProxy Function	Generates a user-level proxy address as a Unicode string.	When a recipient object is created, or when an address type is installed or updated for all recipients.
RcValidateProxy Function	Validates that a proxy address string is a valid address in the remote system. Also allowed to correct invalid addresses, if possible.	When a proxy address is edited manually.
RcUpdateProxy Function	Updates the site proxy portion of a proxy address.	When a proxy address is updated.
RcValidateSiteProxy Function	Validates that a site proxy address is a valid address in the remote system.	When a site proxy address is edited manually.
FreeProxy Function	Frees memory allocated for a proxy address string.	When generation of proxy addresses is complete.
CloseProxies Function	Closes a proxy address generation session and frees any associated memory.	When creation of a recipient object is complete.

For more information about proxy addresses, read the Proxy Addresses section.