Ссылка CFNetDiagnostics

CFNetDiagnostics непрозрачный тип позволяет Вам диагностировать сетевые проблемы.

Функции

Создание сетевого объекта диагностики


    
    CFNetDiagnosticCreateWithStreams (_: _: _:)
    CFNetDiagnosticCreateWithStreams

Создает сетевой диагностический объект из пары CFStreams.

Объявление

Swift

func CFNetDiagnosticCreateWithStreams(_ alloc: CFAllocator!, _ readStream: CFReadStream!, _ writeStream: CFWriteStream!) -> Unmanaged<CFNetDiagnostic>!

Objective C

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

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`readStream`	Ссылка на поток чтения, связь которого прервалась, или `NULL` если Вы не хотите, чтобы CFNetDiagnosticRef имел поток чтения.
`writeStream`	Ссылка на поток записи, связь которого прервалась, или `NULL` если Вы не хотите, чтобы CFNetDiagnosticRef имел поток записи.
`function result`	CFNetDiagnosticRef, которому можно передать `CFNetDiagnosticDiagnoseProblemInteractively` или `CFNetDiagnosticCopyNetworkStatusPassively`. Владение соблюдает Создать Правило.

Обсуждение

Эта функция использует ссылки на пар чтения и поток записи (или просто поток чтения или просто поток записи) для создания ссылки на экземпляр объекта CFNetDiagnostic. Можно передать ссылку на CFNetDiagnosticDiagnoseProblemInteractively открыть окно Network Diagnostics или для CFNetDiagnosticCopyNetworkStatusPassively получить описание соединения, на которое ссылаются readStream и writeStream.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение, пока другой поток не изменяет тот же CFNetDiagnosticRef одновременно.

Оператор импорта

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в версии 10.4 OS X и позже.


    
    CFNetDiagnosticCreateWithURL (_: _:)
    CFNetDiagnosticCreateWithURL

Создает CFNetDiagnosticRef из CFURLRef.

Объявление

Swift

func CFNetDiagnosticCreateWithURL(_ alloc: CFAllocator!, _ url: CFURL!) -> Unmanaged<CFNetDiagnostic>!

Objective C

CFNetDiagnosticRef CFNetDiagnosticCreateWithURL ( CFAllocatorRef alloc, CFURLRef url );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для нового объекта. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`url`	CFURLRef, относящийся к неработающему соединению.

Возвращаемое значение

CFNetDiagnosticRef, которому можно передать CFNetDiagnosticDiagnoseProblemInteractively или CFNetDiagnosticCopyNetworkStatusPassively. Владение соблюдает Создать Правило.

Обсуждение

Эта функция использует URL для создания ссылки на экземпляр объекта CFNetDiagnostic. Можно передать ссылку на CFNetDiagnosticDiagnoseProblemInteractively открыть окно Network Diagnostics или для CFNetDiagnosticCopyNetworkStatusPassively получить описание соединения, на которое ссылаются readStream и writeStream.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение, пока другой поток не изменяет тот же CFNetDiagnosticRef одновременно.

Оператор импорта

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в версии 10.4 OS X и позже.

Функции CFNetDiagnostics


    
    CFNetDiagnosticSetName (_: _:)
    CFNetDiagnosticSetName

Переопределяет выведенное на экран имя приложения.

Объявление

Swift

func CFNetDiagnosticSetName(_ details: CFNetDiagnostic!, _ name: CFString!)

Objective C

void CFNetDiagnosticSetName ( CFNetDiagnosticRef details, CFStringRef name );

Параметры

`details`	Объект диагностики сети, для которого должно быть установлено имя приложения.
`name`	Имя, которое должно быть определено.

Обсуждение

Платформы, требующие, чтобы имя приложения быть выведенным на экран пользователю получило имя приложения из идентификатора пакета в настоящее время запущенного приложения в локализации того приложения. Если Вы хотите переопределить полученное имя приложения, используйте эту функцию для определения выведенного на экран имени.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение, пока другой поток не изменяет тот же CFNetDiagnosticRef одновременно.

Оператор импорта

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в версии 10.4 OS X и позже.


    
    CFNetDiagnosticDiagnoseProblemInteractively (_:)
    CFNetDiagnosticDiagnoseProblemInteractively

Открывает окно Network Diagnostics.

Объявление

Swift

func CFNetDiagnosticDiagnoseProblemInteractively(_ details: CFNetDiagnostic!) -> CFNetDiagnosticStatus

Objective C

CFNetDiagnosticStatus CFNetDiagnosticDiagnoseProblemInteractively ( CFNetDiagnosticRef details );

Параметры


      details

Объект диагностики сети, создаваемый CFNetDiagnosticCreateWithStreams или CFNetDiagnosticCreateWithURL, для которого должно быть открыто окно.

Возвращаемое значение

CFNetDiagnosticNoErr если никакая ошибка не произошла, или CFNetDiagnosticErr если ошибка произошла, который препятствовал тому, чтобы этот вызов завершился успешно.

Обсуждение

Эта функция открывает окно Network Diagnostics и сразу возвращается, как только окно открыто.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение, пока другой поток не изменяет тот же CFNetDiagnosticRef одновременно.

Оператор импорта

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в версии 10.4 OS X и позже.


    
    CFNetDiagnosticCopyNetworkStatusPassively (_: _:)
    CFNetDiagnosticCopyNetworkStatusPassively

Получает значение состояния сети.

Объявление

Swift

func CFNetDiagnosticCopyNetworkStatusPassively(_ details: CFNetDiagnostic!, _ description: UnsafeMutablePointer<Unmanaged<CFString>?>) -> CFNetDiagnosticStatus

Objective C

CFNetDiagnosticStatus CFNetDiagnosticCopyNetworkStatusPassively ( CFNetDiagnosticRef details, CFStringRef *description );

Параметры

`details`	CFNetDiagnosticRef, создаваемый `CFNetDiagnosticCreateWithStreams` или `CFNetDiagnosticCreateWithURL`, для которого должно быть получено состояние Network Diagnostics.
`description`	Если нет `NULL`, по возврату содержит локализованную строку, содержащую описание текущего состояния сети. Владение соблюдает Создать Правило.

Возвращаемое значение

Значение состояния сети.

Обсуждение

Эта функция возвращает значение состояния, которое может использоваться для отображения основной информации о соединении, и дополнительно получает локализованную строку, содержащую описание текущего состояния сети.

Эта функция, как гарантируют, не генерирует сетевую активность.

Специальные замечания

Эта функция ориентирована на многопотоковое исполнение, пока другой поток не изменяет тот же CFNetDiagnosticRef одновременно.

Оператор импорта

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в версии 10.4 OS X и позже.

Типы данных

CFNetDiagnosticRef

Непрозрачная ссылка, представляющая CFNetDiagnostic.

Объявление

Swift

typealias CFNetDiagnosticRef = CFNetDiagnostic

Objective C

typedef struct __CFNetDiagnostic* CFNetDiagnosticRef;

Доступность

Доступный в версии 10.4 OS X и позже.
CFNetDiagnosticStatus

Тип CFIndex, привыкший к значениям статуса возврата от CFNetDiagnostic состояние и диагностические функции. Для списка возможных значений посмотрите Константы CFNetDiagnosticStatusValues.

Объявление

Swift

typealias CFNetDiagnosticStatus = CFIndex

Objective C

typedef CFIndex CFNetDiagnosticStatus;

Доступность

Доступный в версии 10.4 OS X и позже.

Константы

Константы CFNetDiagnosticStatusValues
Константы для значений состояния диагностики.

Объявление

Swift

enum CFNetDiagnosticStatusValues : Int32 { case NoErr case Err case ConnectionUp case ConnectionIndeterminate case ConnectionDown }

Objective C

enum CFNetDiagnosticStatusValues { kCFNetDiagnosticNoErr = 0, kCFNetDiagnosticErr = -66560L, kCFNetDiagnosticConnectionUp = -66559L, kCFNetDiagnosticConnectionIndeterminate = -66558L, kCFNetDiagnosticConnectionDown = -66557L }; typedef enum CFNetDiagnosticStatusValues CFNetDiagnosticStatusValues;

Константы
- NoErr
  
  kCFNetDiagnosticNoErr
  
  Никакая ошибка не произошла, но нет никакого состояния.
  
  Доступный в OS X v10.4 и позже.
- Err
  
  kCFNetDiagnosticErr
  
  Ошибка произошла, который препятствовал тому, чтобы завершился вызов.
  
  Доступный в OS X v10.4 и позже.
- ConnectionUp
  
  kCFNetDiagnosticConnectionUp
  
  Соединение, кажется, работает.
  
  Доступный в OS X v10.4 и позже.
- ConnectionIndeterminate
  
  kCFNetDiagnosticConnectionIndeterminate
  
  Состояние соединения не известно.
  
  Доступный в OS X v10.4 и позже.
- ConnectionDown
  
  kCFNetDiagnosticConnectionDown
  
  Соединение, кажется, не работает.
  
  Доступный в OS X v10.4 и позже.
Обсуждение

Значения состояния диагностики возвращаются CFNetDiagnosticDiagnoseProblemInteractively и CFNetDiagnosticCopyNetworkStatusPassively.

Оператор импорта

Objective C

@import CFNetwork;

Swift

import CFNetwork

Доступность

Доступный в версии 10.4 OS X и позже.