pub unsafe extern "C-unwind" fn SecTransformExecute(
transform_ref: &SecTransform,
error_ref: *mut *mut CFError,
) -> CFRetained<CFType>
SecTransform
only.Expand description
Executes a Transform or transform group synchronously.
Parameter transformRef
: The transform to execute.
Parameter errorRef
: An optional pointer to a CFErrorRef. This value
will be set if an error occurred during
initialization or execution of the transform or group.
If not NULL the caller will be responsible for releasing
the returned CFErrorRef.
Returns: This is the result of the transform. The specific value is determined by the transform being executed.
There are two phases that occur when executing a transform. The first phase checks to see if the tranforms have all of their required attributes set. If a GroupTransform is being executed, then a required attribute for a transform is valid if it is connected to another attribute that supplies the required value. If any of the required attributes are not set or connected then SecTransformExecute will not run the transform but will return NULL and the apporiate error is placed in the error parameter if it is not NULL.
The second phase is the actual execution of the transform. SecTransformExecute executes the transform or GroupTransform and when all of the processing is completed it returns the result. If an error occurs during execution, then all processing will stop and NULL will be returned and the appropriate error will be placed in the error parameter if it is not NULL.
ยงSafety
transform_ref
should be of the correct type.error_ref
must be a valid pointer or null.