9.172 PUT_REGISTRY_VALUE
注意: 9.1 組み込み関数の規則 &<a href="bifcat3_02.htm"&>利用オプション&</a&>
処理
指定されたレジストリ・キーの値を追加/更新します。
引数の長さに50を超える値の指定が許されるのは、フィールドの場合だけです。リテラル値は最大50桁までに制限されます。特に、この条件はこの組み込み関数の最初の4つの引数に当てはまります。引数にフィールドが使用される場合を除いて、これらの引数の長さはすべて50桁に制限されます。
引数
番号 |
タイプ |
必須/任意 |
記述 |
最小長 |
最大長 |
最小小数桁数 |
最大小数桁数 |
1 |
A |
必須 |
レジストリ・ルート |
1 |
256 |
|
|
2 |
u |
必須 |
レジストリ・パス |
1 |
256 |
|
|
3 |
u |
必須 |
レジストリ・キー名 |
1 |
256 |
|
|
4 |
X |
必須 |
レジストリ・キー値： 詳細については、「レジストリ・キー値に関する注意事項 」を参照してください。 |
1 |
制限なし |
|
制限なし |
5 |
A |
任意 |
値のタイプ： S - String B - Binary D - DWORD X - 環境変数を含むことのできる拡張文字列 詳細については、「サポートされるキー・タイプとキー・タイプのデフォルト 」を参照してください。 |
1 |
1 |
0 |
|
6 |
A |
任意 |
キーの作成： Y - レジストリが存在しない場合、レジストリを作成する N - キーを作成しない デフォルト - N |
1 |
1 |
|
|
7 |
N |
O |
使用するレジストリ ハイブ: 32 or 64 その他の値の場合は、アプリケーションのデフォルトが使用されます。つまり、32 ビットのアプリケーションは、wow6432 に、64 ビットのアプリケーションは wow6464 に書き込むということです。 |
1 |
4 |
0 |
0 |
戻り値
番号 |
タイプ |
必須/任意 |
記述 |
最小長 |
最大長 |
最小小数桁数 |
最大小数桁数 |
1 |
A |
必須 |
戻りコード |
2 |
2 |
|
|
レジストリ・キー値に関する注意事項
フィールド値 (Binary、VarBinary以外) の保存にSタイプが使用される場合、フィールドは文字列の形式でリポジトリに保存されます。
Alpha、Char、またはStringフィールドの保管にBタイプが使用される場合、フィールド値は16進数文字列と見なされ、実際の値に変換されます。Alpha、Char、またはStringフィールドの各桁は、1、2、3、4、5、6、7、8、9、A、B、C、D、E、Fのいずれかでなければなりません。16進数文字以外が見つかった場合、それは'0'(ゼロ)に置き換えられます。
Alpha、Char、またはStringフィールドの保管にDタイプが使用される場合、フィールド値は16進数文字列表現の値と見なされ、実際の値に変換されます。
「サポートされるキー・タイプとキー・タイプのデフォルト 」の表では、デフォルトで定義されるキータイプと、各フィールドに対してサポートされるキー・タイプが示されています。5番目の引数の指定がない場合は、デフォルトが適用されます。このデフォルトの使用が強く勧められています。
サポートされないキー・タイプが使用された場合、致命的なエラーが発生すると共にメッセージが出力されます。メッセージは、サポートされないキー・タイプを使用しています。と出力されます。
サポートされるキー・タイプとキー・タイプのデフォルト
フィールド・タイプ |
キー・タイプのデフォルト |
サポートされるキー・タイプ |
Alpha、 Char、およびString |
S |
S、B、D、X |
CLOB、 BLOB、Time、 Date、DateTime、 Packed、Signed、Float BooleanおよびInteger |
S |
S、X |
8 バイト未満のInteger |
S |
S、D、X |
Binary VarBinary |
B |
B |