Резервная базовая ссылка

Резервное Ядро является языком C API, предоставляющий низкоуровневый интерфейс к файлу и настройкам папки, используемым Резервным копированием. Представленный в OS X v10.5, Резервное копирование является встроенным, конфигурируемым пользователем решением для резервного копирования, защищающим пользовательские данные от случайной потери.

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

Функции

Управление резервным состоянием исключения элемента


    
    CSBackupSetItemExcluded (_: _: _:)
    CSBackupSetItemExcluded

Включает или исключает элемент из резервного копирования.

Объявление

Swift

func CSBackupSetItemExcluded(_ item: CFURL!, _ exclude: Boolean, _ excludeByPath: Boolean) -> OSStatus

Objective C

OSStatus CSBackupSetItemExcluded ( CFURLRef item, Boolean exclude, Boolean excludeByPath );

Параметры

`item`	URL файла или папки, которая будет включена или исключена из резервного копирования.
`exclude`	Передача `true` исключить этот элемент из резервного копирования (Резервное копирование не скопирует этот элемент). Передача `false` остановиться, исключая этот элемент (Резервное копирование скопирует этот элемент, если пользователь так выберет).
`excludeByPath`	Передача `true` указать, что этот элемент исключен из-за его расположения (его абсолютный путь). Передача `false` указать, что этот элемент исключен независимо от его расположения (и независимо от того, перемещает ли пользователь элемент).

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

Код результата. Возвраты noErr если элемент был успешно включен или исключен из резервного копирования.

Обсуждение

Резервное копирование пропускает файлы и папки, отмеченные для исключения. Если папка отмечена для исключения, папка и все ее содержание исключены из процесса резервного копирования. Можно исключить определенные пути, еще не существующие, но что Вы планируете создать позже путем передачи запланированного URL в item и передача true в excludeByPath. Обратите внимание на то, что, если Вы передаете false в excludeByPath, URL должен уже существовать.

Ваше приложение может позволить пользователям изменять резервное состояние исключения любого файла или папки, к которой это имеет доступ для записи. Для изменения резервного состояния исключения пути приложение должно работать с правами администратора.

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

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

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


    
    CSBackupIsItemExcluded (_: _:)
    CSBackupIsItemExcluded

Возвращает булево значение, указывающее, исключается ли элемент в настоящее время из резервного копирования.

Объявление

Swift

func CSBackupIsItemExcluded(_ item: CFURL!, _ excludeByPath: UnsafeMutablePointer<Boolean>) -> Boolean

Objective C

Boolean CSBackupIsItemExcluded ( CFURLRef item, Boolean *excludeByPath );

Параметры


      item

URL элемента.


      excludeByPath

Если true, резервное состояние исключения элемента применяется к своему расположению; если false, резервное состояние исключения элемента применяется к себе, независимо от его расположения. Посмотрите CSBackupSetItemExcluded для получения дополнительной информации. Может быть NULL.

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

true если элемент или какой-либо из его наследователей в настоящее время исключаются из резервного копирования, false иначе.

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

Objective C

@import CoreServices;

Swift

import CoreServices

Доступность

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