Creates a DOFDomain that uses the specified configuration.
The DOFDomain can be used to monitor connectivity to a secure domain's Authentication Server.
The internal library tracks references to duplicate domains, so this function can safely be called multiple times with the same configuration without consuming extra resources. Multiple references to a DOFDomain can easily occur, because the library automatically creates DOFDomain instances when you pass a DOFDomainConfig in the following functions:
- Resource Management:
- This function allocates resources that must later be freed by calling DOFDomain_Destroy.
- Parameters
-
self | The DOF to create the domain on. This must not be NULL . |
config | An instance of DOFDomainConfig that represents a source of configuration parameters for the DOFDomain. Use DOFDomainConfigBuilder to create an instance of DOFDomainConfig. This should not be NULL . |
- Returns
- A new instance of DOFDomain.
- Exceptions
-
NULL | is returned if the configuration is invalid or the DOFDomain could not be created. |