Starts resolution for a host object.
SDKs
- iOS 2.0+
- macOS 10.3+
- Mac Catalyst 13.0+
- tvOS 9.0+
Framework
- CFNetwork
Declaration
Boolean CFHostStartInfoResolution(CFHost Ref theHost, CFHost Info Type info, CFStream Error *error);
Parameters
theHost
The host, obtained by previously calling
CFHost
,Create Copy CFHost
, orCreate With Address CFHost
, that is to be resolved. This value must not beCreate With Name NULL
.info
A value of type
CFHost
specifying the type of information that is to be retrieved. SeeInfo Type CFHost
for possible values.Info Type error
A pointer to a
CFStream
structure, that, if an error occurs, is set to the error and the error’s domain. In synchronous mode, the error indicates why resolution failed, and in asynchronous mode, the error indicates why resolution failed to start.Error
Return Value
TRUE
if the resolution was started (asynchronous mode); FALSE
if another resolution is already in progress for the
or if an error occurred.
Discussion
This function retrieves the information specified by info
and stores it in the host.
In synchronous mode, this function blocks until the resolution has completed, in which case this function returns TRUE
, until the resolution is stopped by calling CFHost
from another thread, in which case this function returns FALSE
, or until an error occurs.
Special Considerations
This function is thread safe.