Core Foundation > CFPreferencesSetValue(_:_:_:_:_:)
関数
CFPreferencesSetValue(_:_:_:_:_:)
指定したドメインの環境設定値を追加、変更、または削除します。
宣言
パラメータ
| key | 設定したい値の環境設定キー。 |
| value | key とアプリケーションに設定する値。ドメインから key を削除するには、NULL を渡します。 |
| applicationID | その環境設定を変更したいアプリケーションの ID。Java パッケージ名 com.foosoft の形式をとります。 |
| userName | 現在のユーザの環境設定を変更するには kCFPreferencesCurrentUser を指定し、それ以外の場合は kCFPreferencesAnyUser を使用してすべてのユーザの環境設定を変更します。 |
| hostName | 現在のホストの環境設定を変更するには kCFPreferencesCurrentHost を指定し、そうでない場合は kCFPreferencesAnyHost を指定してすべてのホストの環境設定を変更します。 |
議論
この関数は、より高いレベルの環境設定関数 CFPreferencesSetAppValue(_:_:_:) の原始設定メカニズムです。指定された正確なドメインのみが変更されます。特定の必要がない限り、この関数を直接使用しないでください。value を除くすべての引数は NULL であってはなりません。任意のユーザ名とホスト名を使用せず、代わりにあらかじめ定義された定数を渡して下さい。
変更を永続的な記憶装置に保存するには、CFPreferencesSynchronize(_:_:_:) 関数を呼び出さなければなりません。root 特権 (または OS X v10.6 以前では管理者特権) を持っている場合に限り、"全てののユーザ" の環境設定を保存できる事に注意して下さい。