II3IDHandler::GenerateI3PUB Method

Synopsis

Generates a .i3pub file in the specified path. An .i3pub file packages information about a handler, so that the handler can be saved to disk and published later. This intermediate file format contains the handler's .class file, configuration data needed by Directory Services, audio prompt data, and a copy of the .ihd file, along with everything else needed for publish. An .i3pub file can be transferred and published on an entirely different server.

IDL Function Prototype

HRESULT GenerateI3PUB(

   [in] BSTR DestFilePath,

   [in, optional, defaultvalue(0)] VARIANT_BOOL Activate,

   [in, optional, defaultvalue(0)] VARIANT_BOOL Primary,

   [in, optional] BSTR Category,

   [in, optional] VARIANT_BOOL OverwriteIfFileExists

);

C/C++ Syntax

HRESULT GenerateI3PUB(BSTR DestFilePath, VARIANT_BOOL Activate, VARIANT_BOOL Primary, BSTR Category, VARIANT_BOOL OverwriteIfFileExists);

Parameters

DestFilePath

The fully qualified path and filename of the .i3pub file.

Activate

Specify True to activate the handler after it is published.

Primary

Specify True if the handler is a Primary handler; or False if it is a Monitor handler.

Category

This optional input parameter permits you to categorize the handler. Typical subroutine category entries are: Email Queuing, EMS, Generic Object, Interaction Attendant, IWeb, Reports, Support, System, Telephony, Voicemail, or Web.

OverwriteIfFileExists

To overwrite an existing .i3pub file if one exists, specify True.