Share via

FrameworkBase.SetBookmark Method

  • Article

Specifies the earliest date and time of the information returned by the GetData method.

 public abstract void FrameworkBase.SetBookmark(
    Guid registrationId,
    DataChanges dataChangeFlags,
    DateTime time
);

Parameters

  • registrationId
    The connector's registration ID. The registration ID is obtained from the initial call to the FrameworkBase.Setup method.
  • dataChangeFlags
    Specifies which bookmarks to modify.
  • time
    The bookmark's new date and time value.

Exceptions

Exception Type Condition
System.ArgumentOutOfRangeException This exception is caused by passing a dataChangeFlags value that is not valid.
System.InvalidOperationException This exception is caused by passing a registrationId value that is not valid.

Remarks

A separate bookmark exists for each DataChanges type the connector is monitoring. Each type corresponds to a separate DataTable object in the DataSet returned by the GetData method. If the bookmarks for each type require different time values, you must call the SetBookmark method more than once using different argument values.

All data older than the bookmark's new date is automatically marked as acknowledged and cleared from the connector's MCF cache.

Requirements

Platforms: Requires Windows 2000 Server or later

Version: Requires MOM 2000 SP1 or later

Namespace: Microsoft.EnterpriseManagement.Mom.Connector

Assembly: MomConnectorFramework (in MomConnectorFramework.dll)

See Also

FrameworkBase Class | FrameworkBase Members | Working with Date and Time Values in the MCF