環境設定ドメイン


新しい環境設定を作成する場合や既存の環境設定を検索する場合、Core Foundation は "環境設定ドメイン" という概念を使用して、環境設定の範囲と位置を指定します。環境設定ドメインは、アプリケーション ID、ホスト名、およびユーザ名の 3 つの情報から構成されます。表 1 に、すべての環境設定ドメインを示し、環境設定値の位置を突き止める際に検索される順にリストされています。


表 1 : 検索順での環境設定ドメイン


1現在のユーザ現在のアプリケーション現在のホスト
2現在のユーザ現在のアプリケーションすべてのホスト
3現在のユーザ全てのアプリケーション現在のホスト
4現在のユーザ全てのアプリケーションすべてのホスト
5全てのユーザ現在のアプリケーション現在のホスト
6全てのユーザ現在のアプリケーション全てのホスト
7全てのユーザ全てのアプリケーション現在のホスト
8全てのユーザ全てのアプリケーション全てのホスト


高レベルの環境設定関数 CFPreferencesSetAppValueCFPreferencesCopyAppValue を使用する場合は、アプリケーション ID のみを指定する必要があります。最初の関数 CFPreferencesSetAppValue は、アプリケーションの "現在のユーザー" および "全てのホスト" ドメインに環境設定値を配置します。つまり、アプリケーションの環境設定の標準的な位置は、表 1 に示すドメイン番号 2 です。その他の関数、 CFPreferencesCopyAppValue は、値が見つかるまで全てのドメインを順番に検索します。これらの関数の使用方法について詳しくは、高レベル環境設定 API の使用 を参照してください。


ドメイン修飾子


環境設定値に正確なドメインを指定する必要がある場合は、低レベル環境設定関数 CFPreferencesSetValueCFPreferencesCopyValue を使用できます。これらの関数を使用すると、環境設定を設定または検索するときに 3 つのドメイン修飾子をすべて指定できます。これらの関数を使用する場合、任意のホスト名とユーザー名を渡すことはできません。代わりに以下のリストにある適切な "Any" または "Current" 定数を使用する必要があります。アプリケーションドメイン修飾子の場合、アプリケーション ID、または以下のリストにある "Any" または "Current" アプリケーション定数のいずれかを渡すことができます。これらの関数の使用方法については、低レベルの環境設定 API の使用 を参照してください。


kCFPreferencesAnyApplication
kCFPreferencesCurrentApplication
kCFPreferencesAnyHost
kCFPreferencesCurrentHost
kCFPreferencesAnyUser
kCFPreferencesCurrentUser


前の章 次の章



目次
Xcode の新機能

  • Core Foundation の環境設定プログラミングトピックスへの序言
  • この文書の構成
  • 環境設定のベストの実践
  • いつどの API を使用するか
  • プロセス境界を越えた環境設定の同期
    環境設定ファイルの位置とデバッグ
    管理された環境設定
    アプリケーション ID
  • 環境設定ドメイン
  • ドメイン修飾子
  • 高レベル環境設定 API の使用
  • 簡単な環境設定を格納する
    簡単な環境設定を読み込む
    簡単な環境設定の更新
    低レベル環境設定 API の使用
    文書改訂履歴












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)












    トップへ(Core Foundation)