RegCreateKeyA 関数 (winreg.h)

指定したレジストリ キーを作成します。 キーがレジストリに既に存在する場合は、関数によってキーが開かれます。

構文

LSTATUS RegCreateKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [out]          PHKEY  phkResult
);

パラメーター

[in] hKey

開いているレジストリ キーへのハンドル。 呼び出し元のプロセスには、キーへのKEY_CREATE_SUB_KEYアクセス権が必要です。 詳細については、「レジストリ キーのセキュリティとアクセス権のを する」を参照してください。

キー作成のアクセスは、ハンドルが取得されたときに指定されたアクセス マスクではなく、レジストリ キーのセキュリティ記述子に対してチェックされます。 したがって、hKey がKEY_READの samDesired で開かれた場合でも、セキュリティ記述子で許可されている場合はキーを作成する操作で使用できます。

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

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] lpSubKey

この関数が開くか作成するキーの名前。 このキーは、hKey パラメーターによって識別されるキーのサブキーである必要があります。

キー名の詳細については、「レジストリの 構造」を参照してください。

hKey が定義済みのキーの 1 つである場合、lpSubKey NULL可能性があります。 その場合、phkResult は、関数に渡された同じ hKey ハンドルを受け取ります。

[out] phkResult

開いているキーまたは作成されたキーへのハンドルを受け取る変数へのポインター。 キーが定義済みのレジストリ キーの 1 つでない場合は、ハンドルの使用が完了した後、RegCloseKey 関数を呼び出します。

戻り値

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

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

備考

アプリケーションは、HKEY_USERS または HKEY_LOCAL_MACHINEの直接の子であるキーを作成できません。 アプリケーションは、HKEY_USERS または HKEY_LOCAL_MACHINE ツリーの下位レベルでサブキーを作成できます。

サービスまたはアプリケーションが異なるユーザーを偽装する場合は、この関数を HKEY_CURRENT_USERで使用しないでください。 代わりに、RegOpenCurrentUser 関数を呼び出します。

RegCreateKey 関数は、指定したパスに不足しているすべてのキーを作成します。 アプリケーションでは、この動作を利用して、一度に複数のキーを作成できます。 たとえば、アプリケーションでは、lpSubKey パラメーターに次の形式の文字列を指定することで、前の 3 つのサブキーと同時に 4 つのレベルの深さのサブキーを作成できます。

subkey1\subkey2\subkey3\subkey4

パス内の既存のキーのスペルが正しくない場合、この動作によって不要なキーが作成されることに注意してください。

必要条件

関連項目

RegCloseKey

RegCreateKeyEx の

RegDeleteKey を する

RegOpenKeyEx を する

レジストリ関数 を する

レジストリの概要