Ссылка SCPreferencesPath

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

Функции в этом интерфейсе программирования просматривают данные как набор словарей пар ключ/значение и связанного пути. Корневой путь (» / «) идентифицирует словарь верхнего уровня. Дополнительные компоненты контура указывают ключи для подсловарей.

Например, к следующему словарю можно получить доступ через два пути. Корневой путь (» / «) возвращает словарь со всеми ключами и значениями. Путь «/path1» возвращает только словарь с «key3» и «key4» свойствами.

      <dict>
   <key>key1</key>
   <string>val1</string>
   <key>key2</key>
   <string>val2</string>
   <key>path1</key>
   <dict>
      <key>key3</key>
      <string>val3</string>
      <key>key4</key>
      <string>val4</string>
   </dict>
</dict>


  

Каждый словарь может также включать kSCResvLink (» __ LINK __ «) ключ. Значение, связанное с этим ключом, интерпретируется как ссылка к другому пути. Если этот ключ присутствует, вызов к SCPreferencesPathGetValue функционируйте возвращает словарь, указанный ссылкой.

Функции

Создание нового пути


    
    SCPreferencesPathCreateUniqueChild (_: _:)
    SCPreferencesPathCreateUniqueChild

Создает новый компонент контура, базированный в указанном пути в иерархии словаря.

Объявление

Swift

func SCPreferencesPathCreateUniqueChild(_ prefs: SCPreferences!, _ prefix: CFString!) -> Unmanaged<CFString>!

Objective C

CFStringRef SCPreferencesPathCreateUniqueChild ( SCPreferencesRef prefs, CFStringRef prefix );

Параметры

`prefs`	Предпочтительный сеанс.
`prefix`	Родительский путь.

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

Строка, представляющая новый (уникальный) дочерний путь, или NULL если не существует указанный путь.

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

Objective C

@import SystemConfiguration;

Swift

import SystemConfiguration

Доступность

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

Соединение информации с путем


    
    SCPreferencesPathSetValue (_: _: _:)
    SCPreferencesPathSetValue

Связывает указанный словарь с указанным путем.

Объявление

Swift

func SCPreferencesPathSetValue(_ prefs: SCPreferences!, _ path: CFString!, _ value: CFDictionary!) -> Boolean

Objective C

Boolean SCPreferencesPathSetValue ( SCPreferencesRef prefs, CFStringRef path, CFDictionaryRef value );

Параметры

`prefs`	Предпочтительный сеанс.
`path`	Путь.
`value`	Словарь данных, которые будут сохранены в пути.

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

TRUE если успешный; иначе, FALSE.

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

Objective C

@import SystemConfiguration;

Swift

import SystemConfiguration

Доступность

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


    
    SCPreferencesPathSetLink (_: _: _:)
    SCPreferencesPathSetLink

Связывает ссылку к второму словарю в указанном пути.

Объявление

Swift

func SCPreferencesPathSetLink(_ prefs: SCPreferences!, _ path: CFString!, _ link: CFString!) -> Boolean

Objective C

Boolean SCPreferencesPathSetLink ( SCPreferencesRef prefs, CFStringRef path, CFStringRef link );

Параметры

`prefs`	Предпочтительный сеанс.
`path`	Путь.
`link`	Ссылка, которая будет сохранена в пути.

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

TRUE если успешный; иначе, FALSE.

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

Objective C

@import SystemConfiguration;

Swift

import SystemConfiguration

Доступность

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

Получение или удаление информации, связанной с путем

SCPreferencesPathGetValue (_: _:) SCPreferencesPathGetValue

Возвращает словарь, связанный с указанным путем.

Объявление

Swift

func SCPreferencesPathGetValue(_ prefs: SCPreferences!, _ path: CFString!) -> Unmanaged<CFDictionary>!

Objective C

CFDictionaryRef SCPreferencesPathGetValue ( SCPreferencesRef prefs, CFStringRef path );

Параметры

prefs

Предпочтительный сеанс.

path

Путь.

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

Словарь связался с указанным путем, или NULL если не существует путь.

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

Objective C

@import SystemConfiguration;

Swift

import SystemConfiguration

Доступность

Доступный в OS X v10.1 и позже.
SCPreferencesPathGetLink (_: _:) SCPreferencesPathGetLink

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

Объявление

Swift

func SCPreferencesPathGetLink(_ prefs: SCPreferences!, _ path: CFString!) -> Unmanaged<CFString>!

Objective C

CFStringRef SCPreferencesPathGetLink ( SCPreferencesRef prefs, CFStringRef path );

Параметры

prefs

Предпочтительный сеанс.

path

Путь.

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

Ссылка связалась с указанным путем, или NULL если путь не является ссылкой или не существует.

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

Objective C

@import SystemConfiguration;

Swift

import SystemConfiguration

Доступность

Доступный в OS X v10.1 и позже.
SCPreferencesPathRemoveValue (_: _:) SCPreferencesPathRemoveValue

Удаляет данные, связанные с указанным путем.

Объявление

Swift

func SCPreferencesPathRemoveValue(_ prefs: SCPreferences!, _ path: CFString!) -> Boolean

Objective C

Boolean SCPreferencesPathRemoveValue ( SCPreferencesRef prefs, CFStringRef path );

Параметры

prefs

Предпочтительный сеанс.

path

Путь.

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

TRUE если успешный; иначе, FALSE.

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

Objective C

@import SystemConfiguration;

Swift

import SystemConfiguration

Доступность

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