Function

SecTaskCopyValueForEntitlement

Returns the value of a single entitlement for the represented task.

Declaration

CFTypeRef SecTaskCopyValueForEntitlement(SecTaskRef task, CFStringRef entitlement, CFErrorRef  _Nullable *error);

Parameters

task

The task whose entitlement you want.

entitlement

The name of the entitlement to be fetched.

error

A pointer that the function uses to provide an error object with details if an error occurs. The caller becomes responsible for the object's memory. Pass NULL to ignore the error.

Return Value

The value of the specified entitlement for the process or NULL if the entitlement value could not be retrieved. The type of the returned value depends on the entitlement specified. Call the CFRelease function to free this object's memory when you are done with it.

Discussion

An empty return value may indicate an error, or it may indicate that the entitlement is simply not present. In the latter case, no error is returned.

See Also

Tasks

SecTaskCreateFromSelf

Creates a task object for the current task.

SecTaskCreateWithAuditToken

Creates a task object for the task that sent the Mach message represented by the audit token.

SecTaskRef

The Core Foundation type representing a task.

SecTaskGetTypeID

Returns the unique identifier of the opaque type to which a task object belongs.

SecTaskCopySigningIdentifier

Returns the value of the code signing identifier.

SecTaskCopyValuesForEntitlements

Returns the values of multiple entitlements for the represented task.