Proxy Generation DLL Exports

Each proxy generation DLL must export the following functions:

Function	Description
RcInitProxies	Initializes a new proxy address generation session.
RcGenerateProxy	Generates a user-level proxy address as a Unicode string.
RcValidateProxy	Validates a proxy address.
RcUpdateProxy	Updates the site proxy portion of a proxy address.
RcValidateSiteProxy	Validates site proxy address.
FreeProxy	Frees memory allocated for a proxy address string.
CloseProxies	Closes a proxy address generation session and frees any associated data.

Typical Call Sequence

Creating a New Recipient
When a new recipient is created on the site Exchange server calls the RcGenerateProxy followed by the FreeProxy. If the DLL is not currently loaded, then the calls are preceeded by the RcInitProxies. The result of these 2 or 3 calls is creation of one proxy address.

Bulk Creation of Proxy Addresses
It is possible to generate proxy addresses for all recipients on the site. This is accomplished via a call to the SAD_ScBulkCreateProxy function as I describe in the following sections. When this happens Exchange server calls the RcInitProxies, and then the RcGenerateProxy followed by the FreeProxy for each recipient object. The sequence is then terminated by the CloseProxies call. For example, if you have 307 recipient objects in your site you would see 1 RcInitProxies, followed by 307 pairs RcGenerateProxy/FreeProxy, and one CloseProxies call.

Editing of the Proxy Address
When the proxy address is edited the RcValidateProxy is called once for each new submission of the proxy address. For example, when you hit "Apply" or "Ok" buttons after changing the proxy, the RcValidateProxy is called once.

[ Contents | Home ]