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 functionality provides. Each system created must be destroyed when it is no longer needed.
You can create a DOFSystem that uses a default configuration by passing ( self, NULL, 0, NULL ) in this function. For a full list of DOFSystem defaults, see DOFSystemConfigBuilder_Create.
- Resource Management:
- This function allocates resources that must later be freed by calling DOFSystem_Destroy.
- Parameters
-
| self | The DOF instance to associate the system with. This must not be NULL. |
| config | An instance of DOFSystemConfig that represents a source of configuration parameters for the DOFSystem. Use DOFSystemConfigBuilder to create an instance of DOFSystemConfig. You may pass a NULL argument to use the default configuration. |
| timeout | 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. |
| [out] | pException | An Exception. If pException is NULL, no exception is reported. Otherwise, the output is either a DOFException, or NULL to indicate no exception occurred. DOFException_Destroy must be called to destroy the returned DOFException, if any. |
- Returns
- The newly created DOFSystem, associated with the DOF and using the specified configuration.
- Exceptions
-
| NULL | is returned and pException is set if the DOF cannot accept the new DOFSystem, credentials are set in the configuration that cannot be authenticated, or the DOFSystem could not be created for other reasons. |
