A means by which a call recipient can be reached, such as a phone number or email address.


@interface CXHandle : NSObject


When the telephony provider receives an incoming call or the user starts an outgoing call, the other caller is identified by a CXHandle object. For a caller identified by a phone number, the handle type is CXHandleTypePhoneNumber and the value is a sequence of digits. For a caller identified by an email address, the handle type is CXHandleTypeEmailAddress and the value is an email address. For a caller identified in any other way, the handle type is CXHandleTypeGeneric and the value typically follows some domain-specific format, such as a username, numeric ID, or URL.


Creating New Handles

- initWithType:value:

Initializes a new handle of a given type with the specified value.

Accessing Handle Attributes


The type of the handle.


The value of the handle.

Comparing Handles

- isEqualToHandle:

Returns a Boolean value that indicates whether a given handle is equal to the receiver.



The possible types of handles.


Inherits From

See Also

Call Information


A telephony call.


A programmatic interface for an object that manages a list of active calls and observes call changes.


A collection of methods that are called by a call observer object when a call changes state.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software