IFPCSchedules::Add method

Applies to: desktop apps only

The Add method creates a new FPCSchedule object in the collection and returns a reference to it.

Syntax

HRESULT Add(
  [in]  BSTR Name,
  IFPCSchedule **ppNewSchedule
);

FPCSchedules.Add( _
  ByVal Name As String, _
  ByVal ppNewSchedule As IFPCSchedule _
) As FPCSchedule

Parameters

• Name [in]

  C++	Required. BSTR that specifies the name of the new schedule.
  VB	Required. String that specifies the name of the new schedule.

• ppNewSchedule
  Address of an interface pointer that on return points to the new IFPCSchedule interface created.

Return value

C++

This method can return one of the following:

• S_OK, indicating that the operation succeeded.
• An error code indicating that the operation failed. In this case, the [out] parameter returned is a null object.

VB

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

Remarks

Newly created schedules do not contain any defined hour blocks. You can define hour blocks by calling the methods of an individual FPCSchedule object.

The additional FPCSchedule object created by this method is not saved to persistent storage until after the Save method is called.

Requirements

See also

FPCSchedules

Build date: 7/12/2010