Function

CFNetDiagnosticCreateWithStreams

Creates a network diagnostic object from a pair of CFStreams.

Declaration

CFNetDiagnosticRef CFNetDiagnosticCreateWithStreams(CFAllocatorRef alloc, CFReadStreamRef readStream, CFWriteStreamRef writeStream);

Parameters

alloc

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

readStream

Reference to a read stream whose connection has failed, or NULL if you do not want the CFNetDiagnosticRef to have a read stream.

writeStream

Reference to a write stream whose connection has failed, or NULL if you do not want the CFNetDiagnosticRef to have a write stream.

function result

CFNetDiagnosticRef that you can pass to CFNetDiagnosticDiagnoseProblemInteractively or CFNetDiagnosticCopyNetworkStatusPassively. Ownership follows the The Create Rule.

Discussion

This function uses references to a read steam and a write stream (or just a read stream or just a write stream) to create a reference to an instance of a CFNetDiagnostic object. You can pass the reference to CFNetDiagnosticDiagnoseProblemInteractively to open a Network Diagnostics window or to CFNetDiagnosticCopyNetworkStatusPassively to get a description of the connection referenced by readStream and writeStream.

Special Considerations

This function is thread safe as long as another thread does not alter the same CFNetDiagnosticRef at the same time.

See Also

Network Diagnostics

CFNetDiagnosticRef

An opaque reference representing a CFNetDiagnostic.

CFNetDiagnosticStatusValues

Constants for diagnostic status values.

Deprecated
CFNetDiagnosticCopyNetworkStatusPassively

Gets a network status value.

Deprecated
CFNetDiagnosticCreateWithURL

Creates a CFNetDiagnosticRef from a CFURLRef.

Deprecated
CFNetDiagnosticDiagnoseProblemInteractively

Opens a Network Diagnostics window.

Deprecated
CFNetDiagnosticSetName

Overrides the displayed application name.

Deprecated