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.