Creates a CFSocket object and opens a connection to a remote socket.


CFSocketRef CFSocketCreateConnectedToSocketSignature(CFAllocatorRef allocator, const CFSocketSignature *signature, CFOptionFlags callBackTypes, CFSocketCallBack callout, const CFSocketContext *context, CFTimeInterval timeout);



The allocator to use to allocate memory for the new object. Pass NULL or kCFAllocatorDefault to use the current default allocator.


A CFSocketSignature identifying the communication protocol and address to which the CFSocket object should connect.


A bitwise-OR combination of the types of socket activity that should cause callout to be called. See CFSocketCallBackType for the possible activity values.


The function to call when one of the activities indicated by callBackTypes occurs.


A structure holding contextual information for the CFSocket object. The function copies the information out of the structure, so the memory pointed to by context does not need to persist beyond the function call. Can be NULL.


The time to wait for a connection to succeed. If a negative value is used, this function does not wait for the connection and instead lets the connection attempt happen in the background. If callBackTypes includes kCFSocketConnectCallBack, you will receive a callback when the background connection succeeds or fails.

Return Value

The new CFSocket object, or NULL if an error occurred. Ownership follows the The Create Rule.

See Also

Creating Sockets


Creates a CFSocket object of a specified protocol and type.


Creates a CFSocket object for a pre-existing native socket.


Creates a CFSocket object using information from a CFSocketSignature structure.

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