DOFSystembeginProvide Method (DOFInterface, Int32, DOFObjectProvider, Object)OpenDOF Object Access Library
Used by a Provider to begin providing the specified interface on all objects.

Namespace: org.opendof.core.oal
Assembly: dof-oal (in dof-oal.dll) Version: 7.0.1.2
Syntax

C#
public DOFOperationProvide beginProvide(
	DOFInterface iface,
	int timeout,
	DOFObjectProvider provider,
	Object context
)

Parameters

iface
Type: org.opendof.core.oalDOFInterface
The interface to be provided. This must not be null.
timeout
Type: SystemInt32
Time, in milliseconds, for the provide to remain active. Must be >= 0. Use DOF.TIMEOUT_NEVER to provide indefinitely. Then use DOFOperation.cancel() to quit providing. If used in conjunction with DOFObject.beginSession(DOFInterface, DOFInterfaceID) , use DOF.TIMEOUT_NEVER.
provider
Type: org.opendof.core.oalDOFObjectProvider
The listener to handle requests on this interface. Null = no desired listener (may be used for "marker interfaces"/no provider implementation).
context
Type: SystemObject
A user-definable object that will be passed back in listeners as part of the DOFOperation.

Return Value

Type: DOFOperationProvide
The provide operation that may be used to end providing. Will not be null.
Remarks

Used by a Provider to begin providing the specified interface on all objects.

The Provider will only respond to Get, Set, Invoke, and Define requests. That is, the provider will not respond to any interest-based activity. You will interact with this Provider only from a Requestor that has no interest, meaning a Requestor that will flood its requests.

NOTE: Since all object IDs are accepted, all attributes are accepted too. In a secure deployment, make sure that where the org.opendof.core.oal.security.DOFPermission.Binding.ACTION_PROVIDE action is specified, no objectID is specified and org.opendof.core.oal.security.DOFPermission.Binding.Builder.setAllAttributesAllowed(bool) is true. This will allow the provider to work as an "All Objects" provider.

See Also

Reference