Previous in Contents Next in Contents

RegisterForEvent Method

This method specifies an event for which an event sink listens.

Syntax

ReplicationEventSinkConfig.RegisterForEvent(Event)

Parameters

Event

The event in which the ReplicationEventSinkConfig object is interested.

Remarks

You must have Site Server Publishing administrator privileges on the server to call this method.

If the ProjectFilter property is True, registering an event from any of a project's event sinks also registers the event from all of the other project event sinks. If the ProjectFilter property is False, the registering only affects the current event sink.

See Crsmsg.bas, Crsmsg.h, or Crsmsg.inc in the SDK include directory for the list of events for Visual Basic, C/C++, and Active Server Pages, respectively.

Example

The following example registers the Windows NT event sink to receive file sent events.

Option Explicit 
On Error Resume Next

const CRS_ERROR_NO_MORE_ITEMS  = 0&80003B17
const CRS_EVENT_SENT_FILE    = 0&4000377A

dim ReplServer
set ReplServer = CreateObject("CrsApi.ReplicationServer")
ReplServer.Initialize("")

dim Iterator
Iterator = 0

dim EvSink
On Error Resume Next
do while True
  'Clear any error text
  Err.Clear
  'Get an event sink
  set EvSink = ReplServer.EnumEventSinks(Iterator)

  'Quit if empty object returned (no more instances)
  if IsEmpty(EvSink) then exit do

  'Quit if "No more items" error 
  dim ReplError
  ReplError = Err.Number
  if ReplError = CRS_ERROR_NO_MORE_ITEMS then exit do

  if EvSink.CLSID = "NT" then 
    EvSink.RegisterForEvent(CRS_EVENT_SENT_FILE)
  end if
Loop

'Release objects
set EvSink     = Nothing
set ReplServer = Nothing

See Also

ProjectFilter, UnregisterForEvent, ReplicationServer.AddEventSink, ReplicationServer.EnumEventSinks


© 1997-2000 Microsoft Corporation. All rights reserved.