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(CFHostParameters
theHostThe 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.infoA value of type
CFHostspecifying the type of information that is to be retrieved. SeeInfo Type CFHostfor possible values.Info Type errorA pointer to a
CFStreamstructure, 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.