RegSetValueExA 関数 (winreg.h)

レジストリ キーの指定した値のデータと型を設定します。

構文

LSTATUS RegSetValueExA(
  [in]           HKEY       hKey,
  [in, optional] LPCSTR     lpValueName,
                 DWORD      Reserved,
  [in]           DWORD      dwType,
  [in]           const BYTE *lpData,
  [in]           DWORD      cbData
);

パラメーター

[in] hKey

開いているレジストリ キーへのハンドル。 キーは、KEY_SET_VALUEアクセス権を使用して開かれている必要があります。 詳細については、「 レジストリ キーのセキュリティとアクセス権」を参照してください。

このハンドルは、 RegCreateKeyEx、 RegCreateKeyTransacted、 RegOpenKeyEx、または RegOpenKeyTransacted 関数によって返されます。 また、次の 定義済みキーのいずれかを指定することもできます。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

• HKEY_PERFORMANCE_TEXT
• HKEY_PERFORMANCE_NLSTEXT

[in, optional] lpValueName

設定する値の名前。 この名前の値がまだキーに存在しない場合、関数によってキーに追加されます。

lpValueName が NULL または空の文字列 "" の場合、この関数はキーの名前のない値または既定値の型とデータを設定します。

詳細については、「 レジストリ要素のサイズ制限」を参照してください。

レジストリ キーには既定値はありませんが、名前のない値を 1 つ持つことができます。この値は任意の型にすることができます。

Reserved

このパラメーターは予約されており、0 である必要があります。

[in] dwType

lpData パラメーターによって指されるデータの型。 使用できる型の一覧については、「 レジストリ値の型」を参照してください。

[in] lpData

格納するデータ。

REG_SZなどの文字列ベースの型の場合、文字列は null で終わる必要があります。 REG_MULTI_SZデータ型では、文字列を 2 つの null 文字で終了する必要があります。

[in] cbData

lpData パラメーターが指す情報のサイズ (バイト単位)。 データの型が REG_SZ、REG_EXPAND_SZ、またはREG_MULTI_SZの場合、 cbData には終端の null 文字または文字のサイズを含める必要があります。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は Winerror.h で定義されている 0 以外のエラー コードです。 FormatMessage 関数を FORMAT_MESSAGE_FROM_SYSTEM フラグと共に使用すると、エラーの一般的な説明を取得できます。

注釈

値のサイズは、使用可能なメモリによって制限されます。 ただし、レジストリに大きな値を格納すると、そのパフォーマンスに影響を与える可能性があります。 長い値 (2,048 バイトを超える) は、レジストリに格納されているファイルの場所と共にファイルとして格納する必要があります。

アイコン、ビットマップ、実行可能ファイルなどのアプリケーション要素は、ファイルとして格納し、レジストリに配置しないでください。

dwType がREG_SZ、REG_MULTI_SZ、またはREG_EXPAND_SZ型であり、この関数の ANSI バージョンが使用されている場合 (RegSetValueExA を明示的に呼び出すか、Windows.h ファイルを含める前に UNICODE を定義しない場合)、lpData パラメーターが指すデータは ANSI 文字列である必要があります。 文字列は、レジストリに格納される前に Unicode に変換されます。

特定のレジストリ キーにアクセスする操作はリダイレクトされることに注意してください。 詳細については、「レジストリの仮想化」および「レジストリ内の 32 ビットおよび 64 ビット アプリケーション データ」を参照してください。

レジストリ キーの値を設定するより便利な方法を提供する RegSetKeyValue 関数の使用を検討してください。

要件

こちらもご覧ください

RegSetKeyValue

RegCreateKeyEx

RegFlushKey

RegOpenKeyEx

RegQueryValueEx

レジストリ関数

レジストリの概要