Core Foundation > CFPreferencesCopyValue(_:_:_:_:)
関数
CFPreferencesCopyValue(_:_:_:_:)
与えられたドメインの環境設定値を返します。
宣言
パラメータ
| key | 取得すべき値の環境設定キー。 |
| applicationID | その環境設定を検索すべきアプリケーションの ID。Java パッケージ名 com.foosoft の形式をとります。 |
| userName | kCFPreferencesCurrentUser を使用して現在のユーザー・ドメインを検索します。それ以外の場合は、kCFPreferencesAnyUser を使用して全てののユーザー・ドメインを検索します。 |
| hostName | 現在のホストドメインを検索するには kCFPreferencesCurrentHost、それ以外の場合は kCFPreferencesAnyHost を使用して全てのホストドメインを検索します。 |
戻り値
指定されたドメインの環境設定値。値が見つからなかった場合は、NULL を返します。所有権は 作成規則 に従います。
議論
この関数は、上位レベルの環境設定関数 CFPreferencesCopyAppValue(_:_:) の原始的取得メカニズムです。上位レベルの関数とは異なり、CFPreferencesCopyValue(_:_:_:_:) は、指定された正確なドメインのみを検索します。必要がない限り、この関数を直接使用しないでください。すべての引数は NULL であってはなりません。任意のユーザー名とホスト名を使用せず、その代わりあらかじめ定義されたドメイン修飾子定数を渡して下さい。
この関数から返される値は、変更可能なオブジェクトを使用して値を最近設定した場合でも変更できないことに注意してください。