Microsoft Internet Security and Acceleration Server 2004 SDK

IFPCEventDefinitions::Add[C++]

FPCEventDefinitions.Add [Visual Basic]

[C++]

The Add method creates a new FPCEventDefinition object in the collection and returns a reference to it. A new event definition can be created only through the ISA Server administration COM objects, not in ISA Server Management.

HRESULT Add(
  BSTR Name,
  BSTR EventGUID,
  VARIANT* pAdditionalKeys,
  IFPCEventDefinition** ppNewEvent
);

Parameters

Name
[in] Required. BSTR that specifies the name of the new event. The name should be unique in the collection.
EventGUID
[in] Required. String-formatted globally unique identifier (GUID) of the new event.
pAdditionalKeys
[in, optional] Pointer to a VARIANT containing an array of strings that define subevents for the event. The index of each string is the additional key for the corresponding subevent. The additional key with an index equal to 0 is reserved to indicate all of the subevents defined for the event.
ppNewEvent
[out] Address of an interface pointer that on return points to the new IFPCEventDefinition interface created.

Return Values

This method can return one of the following:

[Visual Basic]

The Add method creates a new FPCEventDefinition object in the collection and returns a reference to it. A new event definition can be created only through the ISA Server administration COM objects, not in ISA Server Management.

Function Add( _
  ByVal Name As String, _
  ByVal EventGUID As String, _
  [ ByRef AdditionalKeys As Variant ] _
) As FPCEventDefinition

Parameters

Name
[in] Required. String that specifies the name of the new event. The name should be unique in the collection.
EventGUID
[in] Required. String-formatted globally unique identifier (GUID) of the new event.
AdditionalKeys
[in, optional] Array of strings that define subevents for the event. The index of each string is the additional key for the corresponding subevent. The additional key with an index equal to 0 is reserved to indicate all of the subevents defined for the event.

Return Values

This method returns a reference to an FPCEventDefinition object if successful. Otherwise, an error is raised that can be intercepted by using an error handler.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Msfpccom.idl.
Library: Use Microsoft Internet Security and Acceleration Server 2004 Administration Library.

See Also

FPCEventDefinitions