REG_CREATE_KEY_INFORMATION 構造体 (wdm.h)

[アーティクル]
03/08/2023

互換性のために残されています。 Windows 7 以降では、代わりに、この構造体の V1 バージョンである REG_CREATE_KEY_INFORMATION_V1 を使用します。

REG_CREATE_KEY_INFORMATION構造体には、ドライバーの RegistryCallback ルーチンが作成中のレジストリキーに使用できる情報が含まれています。

構文

typedef struct _REG_CREATE_KEY_INFORMATION {
  PUNICODE_STRING CompleteName;
  PVOID           RootObject;
  PVOID           ObjectType;
  ULONG           CreateOptions;
  PUNICODE_STRING Class;
  PVOID           SecurityDescriptor;
  PVOID           SecurityQualityOfService;
  ACCESS_MASK     DesiredAccess;
  ACCESS_MASK     GrantedAccess;
  PULONG          Disposition;
  PVOID           *ResultObject;
  PVOID           CallContext;
  PVOID           RootObjectContext;
  PVOID           Transaction;
  PVOID           Reserved;
} REG_CREATE_KEY_INFORMATION, REG_OPEN_KEY_INFORMATION, *PREG_CREATE_KEY_INFORMATION, *PREG_OPEN_KEY_INFORMATION;

メンバー

CompleteName

新しいレジストリキーのパスを含む UNICODE_STRING 構造体へのポインター。パスは絶対パスでも相対パスでもかまいません。パスが絶対パスの場合、この構造体には "\" 文字で始まる完全修飾パスが含まれます。絶対パスの場合、 RootObject メンバーは、レジストリツリーのルートディレクトリである \REGISTRY キーを指定します。パスが相対パスの場合、パスは "\" 以外の文字で始まり、 RootObject メンバーによって指定されたキーに対する相対パスになります。

RootObject

CompleteName メンバーによって指定されたパスのルートとして機能するレジストリキーオブジェクトへのポインター。

ObjectType

ObjectType メンバーは、内部使用のために予約されています。ドライバーは、このメンバーにアクセスできません。

CreateOptions

フラグのビットごとの OR。これらのフラグの詳細については、ZwCreateKey ルーチンの CreateOptions パラメーターを参照してください。

Class

キーのオブジェクトクラスを識別する UNICODE_STRING 構造体へのポインター。このメンバーの詳細については、ZwCreateKey ルーチンの Class パラメーターを参照してください。

SecurityDescriptor

キーオブジェクトのセキュリティ情報を含む SECURITY_DESCRIPTOR 構造体へのポインター。

SecurityQualityOfService

Winnt.h で定義されている SECURITY_QUALITY_OF_SERVICE 構造体へのポインター。

DesiredAccess

レジストリキーを作成しようとしているスレッドによって指定されたアクセスマスク。

GrantedAccess

レジストリキーを作成しようとしているスレッドに付与されたアクセス権を示すアクセスマスク。このメンバーの詳細については、「解説」を参照してください。

Disposition

レジストリキーが作成されたかどうかを示す値。このメンバーの詳細については、ZwCreateKey ルーチンの Disposition パラメーターと、次の「備考」セクションを参照してください。

ResultObject

作成されたレジストリキーを表すキーオブジェクトのアドレスを受け取る場所へのポインター。このメンバーの詳細については、「解説」を参照してください。

CallContext

ドライバーの RegistryCallback ルーチンが提供できるオプションのドライバー定義コンテキスト情報。

RootObjectContext

CmSetCallbackObjectContext を呼び出して、ドライバーがレジストリオブジェクトのパスのルートに関連付けたドライバー定義のコンテキスト情報へのポインター。

Transaction

操作が試行されるトランザクションオブジェクトへのポインター。このメンバーが NULL の場合、操作は非トランザクションコンテキストで実行されます。

Reserved

このメンバーが 1 の場合は、追加のパラメーターを含む REG_CREATE_KEY_INFORMATION_V1 型にこの構造体をキャストしても安全です。

注釈

構成マネージャーは、ユーザーモードスレッドが RegCreateKey または RegCreateKeyEx を呼び出したときや、ドライバーが ZwCreateKey を呼び出すときなど、スレッドがキーを作成しようとするたびに、この構造体を RegistryCallback ルーチンに渡します。

ドライバーの RegistryCallback ルーチンが RegNtPreCreateKeyEx 通知のSTATUS_CALLBACK_BYPASSを返す場合、ドライバーは GrantedAccess、 Disposition、および ResultObject の値を指定する必要があります。

レジストリのフィルター処理操作の詳細については、「レジストリ呼び出しのフィルター処理」を参照してください。