Creates a
DOFSystem
that uses the specified configuration. You must create DOFSystem instances in order to create
DOFObject
instances, which are needed
to perform the majority of operations DOF provides. DOFSystems are associated with the DOF instance used to create them, and only that DOF can route its
operations (see DOF).
Each DOFSystem instance must be destroyed when it is no longer needed. See
DOFSystem.destroy()
and
destroy()
.
This method will block until the system is authorized or timeout expires.
Namespace: org.opendof.core.oal
Assembly: dof-oal (in dof-oal.dll) Version: 7.0.1.2
Syntax
C#
public DOFSystem createSystem( DOFSystemConfig config, int timeout )
Parameters
- config
- Type: org.opendof.core.oalDOFSystemConfig
An instance of Config that represents a source of configuration parameters for the DOFSystem. Use Builder to create an instance of DOFSystem.Config. You may pass a null value to use the default configuration. - timeout
- Type: SystemInt32
Controls how long (in milliseconds) to wait for authentication when credentials have been set in the configuration. If the configuration does not include credentials, the timeout may be zero.
Return Value
Type: DOFSystemThe newly created DOFSystem. The return value will be null if the configuration is invalid or if the DOF cannot accept the new DOFSystem.
Exceptions
Exception | Condition |
---|---|
DOFException | If unable to authenticate the system when credentials have been set in the configuration. |
DOFException |
See Also