OpenDOF Project
boolean DOFConfigBuilder_SetSourceID ( DOFConfigBuilder  self,
DOFObjectIDSource  sourceID 
)

Sets the identifier that is used for the DOF's operations in the unsecured domain.

Operations in secure domains may not use this source identifier. Source identifiers in secure domains may be assigned by the Authentication Server (AS) and thus, would not be under application control.

Source identifiers must be globally unique. By default, the source identifier is a GUID that is randomly generated when the DOFConfigBuilder is created. If you use this method to set a constant value for the source identifier, you should not use a DOFConfig created from this DOFConfigBuilder to instantiate more than one DOF. You should also ensure that you include DOF_CancelAllOperations in the DOF's startup routines.

Parameters
selfthe DOFConfigBuilder to set the source identifier in. This must not be NULL.
sourceIDThe DOFObjectIDSource to use as an identifier in the unsecured domain. This must not be NULL.
Returns
TRUE if the sourceID is set in the DOFConfigBuilder.
Exceptions
FALSEif the sourceID could not be set. The DOFConfigBuilder remains unchanged.
See Also
DOFObjectIDSource_Create
DOFState_GetSourceID
DOFConfig_GetSourceID
core-c-dof-oal Version 8.0.1 Build 0
2018-01-22