Used by a Requestor to begin and maintain an event registration, as specified using a DOFQuery , Control , and a context, to be notified of events and associated value(s). DOFRegistration will select one matching provider and register for its matching event. If there is no matching provider, then DOFRegistration will wait for one. If the provider goes away, then the search will resume for a matching provider.

To cancel the registration, call DOFRegistration.destroy() .

NOTE: The listener should be notified very soon through the Listener.stateChanged(DOFRegistration, State) method that the registration is active, but until an event actually occurs, Listener.eventSignaled(DOFRegistration, DOFObjectID, System.Collections.Generic.IList<E>) won't be called.

NOTE: An application must first express interest by calling beginInterest(DOFObjectID, DOFInterestLevel) . Interest goes out on the network and looks for matching providers. The query, on the other hand, searches through the local set of known providers (those already found through interest). If no interest is specified, then no non-local providers will be found.

public DOFRegistration createRegistration(
	DOFQuery query,
	DOFInterfaceEvent event_Renamed,
	DOFOperationControl control,
	DOFRegistrationListener listener,
	Object context
)