EventNoticeRegister()

Returns a handle.

Token ID

AFTKN_EN_REGISTER or 815

Syntax

DWORD EventNoticeRegister(ANSISTRING DLLPath; 
                           ANSISTRING FunctionName;
                           WORD RegisteredID;
                               WORD Flags)

Parameters

DLLPath As ANSISTRING

Text. Fully qualified file name to a dll/exe containing the function to call when an event occurs.

FunctionName As ANSISTRING

Text. Name of the exported function to call.

RegisteredID As WORD

A 32-bit ID value that will be passed to the function specified in DLLPath and FunctionName. This provides some flexibility since a pointer or handle can be passed to the memory where the function is handled.

Flags As WORD

The events you want notification for. The following are valid events:

  • 0x00000001 EVT_GROUPWISE_SEND_ITEM
  • 0x00000002 EVT_GROUPWISE_CANCEL_ITEM
  • 0x00000004 EVT_GROUPWISE_CLOSE_ITEM
  • 0x00000008 EVT_GROUPWISE_PACKAGING_ITEM
  • 0x00000010 EVT_GROUPWISE_PACKAGING_ITEM_CANCELED
  • 0x00000020 EVT_GROUPWISE_SEND_ITEM_COMPLETED

Return Values

DWORD

Handle.

Remarks

The first important area of code is in Command Execute within the C3PO. GWCommander is used to throw EventNoticeRegister. EventNoticeRegister sets up this association only for the active compose view. If the dialog is not up and focused, the token fails. If the active view is not a compose view, the token fails.

See Also

ItemGetText()