Function

CFHostCreateWithAddress

Uses an address to create an instance of a host object.

Declaration

CFHostRef CFHostCreateWithAddress(CFAllocatorRef allocator, CFDataRef addr);

Parameters

alloc

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

addr

A CFDataRef object containing a sockaddr structure for the address of the host. This value must not be NULL.

Return Value

A valid CFHostRef object that can be resolved, or NULL if the host could not be created. Ownership follows the The Create Rule.

Discussion

Call CFHostStartInfoResolution to resolve the return object’s name and reachability information.

Special Considerations

This function is thread safe.

See Also

Hosts

CFHostRef

An opaque reference representing an CFHost object.

CFHostInfoType

Values indicating the type of data that is to be resolved or the type of data that was resolved.

CFHostClientContext

A structure containing user-defined data and callbacks for CFHost objects.

CFHostCancelInfoResolution

Cancels the resolution of a host.

CFHostCreateCopy

Creates a new host object by copying.

CFHostCreateWithName

Uses a name to create an instance of a host object.

CFHostGetAddressing

Gets the addresses from a host.

CFHostGetNames

Gets the names from a CFHost.

CFHostGetReachability

Gets reachability information from a host.

CFHostGetTypeID

Gets the Core Foundation type identifier for the CFHost opaque type.

CFHostScheduleWithRunLoop

Schedules a CFHost on a run loop.

CFHostSetClient

Associates a client context and a callback function with a CFHost object or disassociates a client context and callback function that were previously set.

CFHostStartInfoResolution

Starts resolution for a host object.

CFHostUnscheduleFromRunLoop

Unschedules a CFHost from a run loop.