ZwCreateKey 関数 (wdm.h)

[アーティクル]
12/21/2024

ZwCreateKey ルーチンは、新しいレジストリキーを作成するか、既存のレジストリキーを開きます。

構文

NTSYSAPI NTSTATUS ZwCreateKey(
  [out]           PHANDLE            KeyHandle,
  [in]            ACCESS_MASK        DesiredAccess,
  [in]            POBJECT_ATTRIBUTES ObjectAttributes,
                  ULONG              TitleIndex,
  [in, optional]  PUNICODE_STRING    Class,
  [in]            ULONG              CreateOptions,
  [out, optional] PULONG             Disposition
);

パラメーター

[out] KeyHandle

キーへのハンドルを受け取る HANDLE 変数へのポインター。

[in] DesiredAccess

オブジェクトへの要求されたアクセスを決定する ACCESS_MASK 値を指定します。呼び出し元は、すべての種類のオブジェクトに対して定義されているアクセス権 (ACCESS_MASKを参照) に加えて、オブジェクトディレクトリに固有の次のアクセス権を 1 つ以上指定できます。

DesiredAccess フラグをする	呼び出し元がこれを行うことを許可します
KEY_QUERY_VALUE	キー値を読み取ります。
KEY_SET_VALUE	キー値を書き込みます。
KEY_CREATE_SUB_KEY	キーのサブキーを作成します。
KEY_ENUMERATE_SUB_KEYS	キーのサブキーを読み取ります。
KEY_CREATE_LINK	キーへのシンボリックリンクを作成します。このフラグは、デバイスドライバーと中間ドライバーでは使用されません。
KEY_NOTIFY	キーの名前、値、または属性が変更されたときに通知を受け取るように要求します。詳細については、「ZwNotifyChangeKey」を参照してください。

呼び出し元は、いくつかのACCESS_MASKフラグを組み合わせた次の定数のいずれかを指定することもできます。

定数	これらのACCESS_MASK フラグで構成されます
KEY_READ	STANDARD_RIGHTS_READ、KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS、およびKEY_NOTIFY
KEY_WRITE	STANDARD_RIGHTS_WRITE、KEY_SET_VALUE、およびKEY_CREATE_SUB_KEY
KEY_EXECUTE	KEY_READと同じです。
KEY_ALL_ACCESS	STANDARD_RIGHTS_ALL、KEY_QUERY_VALUE、KEY_SET_VALUE、KEY_CREATE_SUB_KEY、KEY_ENUMERATE_SUB_KEYS、KEY_NOTIFY、およびKEY_CREATE_LINK

[in] ObjectAttributes

オブジェクト名とその他の属性を指定する OBJECT_ATTRIBUTES 構造体へのポインター。 InitializeObjectAttributes 使用して、この構造体を初期化します。呼び出し元がシステムスレッドコンテキストで実行されていない場合は、InitializeObjectAttributes呼び出すときにOBJ_KERNEL_HANDLE属性を設定する必要があります。

TitleIndex

デバイスドライバーと中間ドライバーでは、このパラメーターを 0 に設定します。

[in, optional] Class

キーのオブジェクトクラスを含む Unicode 文字列へのポインター。この情報は、構成マネージャーによって使用されます。

[in] CreateOptions

キーを作成または開くときに適用するオプションを指定します。次のフラグの互換性のある組み合わせとして指定します。

CreateOptions フラグの	形容
REG_OPTION_VOLATILE	システムの再起動時にキーは保持されません。
REG_OPTION_NON_VOLATILE	キーは、システムの再起動時に保持されます。
REG_OPTION_CREATE_LINK	新しく作成されたキーはシンボリックリンクです。このフラグは、デバイスドライバーと中間ドライバーでは使用されません。
REG_OPTION_BACKUP_RESTORE	キーは、バックアップ操作と復元操作を許可する特別な特権で作成または開く必要があります。このフラグは、デバイスドライバーと中間ドライバーでは使用されません。

[out, optional] Disposition

新しいキーが作成されたか、または既存のキーが開かれたかを示す値を受け取る変数へのポインター。

Disposition 値	形容
REG_CREATED_NEW_KEY	新しいキーが作成されました。
REG_OPENED_EXISTING_KEY	既存のキーが開かれました。

戻り値

ZwCreateKey 、成功した場合はSTATUS_SUCCESS、失敗した場合は適切な NTSTATUS エラーコードが返されます。

備考

ZwCreateKey は、呼び出し元がレジストリキーの操作に使用できるハンドルを提供します。詳細については、「ドライバーでのレジストリの使用」を参照してください。

KeyHandle 指すハンドルが使用されなくなったら、ドライバーは ZwClose 呼び出して閉じる必要があります。

ZwCreateKeyで作成または開くファイルの名前を指定するには、次の 2 つの方法があります。

完全修飾パス名として、入力 ObjectAttributesの ObjectName メンバーで指定されます。レジストリキーのパス名は、\Registryで始まります。
objectAttributes入力の RootDirectory メンバーのハンドルによって表される、別のレジストリキーに対する相対パス名。

ObjectAttributes で指定されたキーが存在しない場合、ルーチンはキーの作成を試みます。この試行を成功させるには、新しいキーが、RootDirectoryによって参照されるキーの直接サブキーである必要があり、rootDirectory 参照するキーが、KEY_CREATE_SUB_KEYアクセスのために開かれている必要があります。

指定したキーが既に存在する場合は、そのキーが開き、その値は影響を受けません。

ObjectAttributes によって指定されたセキュリティ属性は、キーの作成時に、指定された DesiredAccess が、後続の ZwCreateKey および ZwOpenKey呼び出しで許可されるかどうかを決定します。

呼び出し元がシステムスレッドコンテキストで実行されていない場合は、作成するハンドルがプライベートハンドルであることを確認する必要があります。それ以外の場合は、ドライバーが実行されているコンテキスト内のプロセスによってハンドルにアクセスできます。詳細については、「オブジェクトハンドル」を参照してください。

レジストリキーの操作の詳細については、「ドライバーでのレジストリの使用」を参照してください。

この関数の呼び出しがユーザーモードで発生する場合は、"ZwCreateKey" ではなく"NtCreateKey" という名前を使用する必要があります。

Windows カーネル NtCreateKey ルーチンは、カーネルモードドライバーから直接アクセスできません。

カーネルモードドライバーからの呼び出しの場合、Windows ネイティブシステムサービスルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。ルーチンの NtXxx と ZwXxx バージョンの間の関係の詳細については、「ネイティブシステムサービスルーチンの Nt および Zw バージョンの使用を参照してください。

必要条件

要件	価値
ターゲットプラットフォームの	万国
ヘッダー	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則をする	HwStorPortProhibitedDDDIs(storport), IrqlZwPassive(wdm), PowerIrpDDis(wdm), 2ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(wdm)

次の方法で共有

ZwCreateKey 関数 (wdm.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース