REG_CREATE_KEY_INFORMATION-Struktur (wdm.h)

Artikel
02/27/2024

Veraltet. Verwenden Sie ab Windows 7 stattdessen REG_CREATE_KEY_INFORMATION_V1, die V1-Version dieser Struktur.

Die REG_CREATE_KEY_INFORMATION-Struktur enthält Informationen, die die RegistryCallback-Routine eines Treibers verwenden kann, wenn ein Registrierungsschlüssel erstellt wird.

Syntax

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;

Member

CompleteName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die den Pfad des neuen Registrierungsschlüssels enthält. Der Pfad kann absolut oder relativ sein. Wenn der Pfad absolut ist, enthält diese Struktur einen vollqualifizierten Pfad, der mit dem Zeichen "\" beginnt. Für einen absoluten Pfad gibt das RootObject-Element den Schlüssel \REGISTRY an, bei dem es sich um das Stammverzeichnis der Registrierungsstruktur handelt. Wenn der Pfad relativ ist, beginnt der Pfad mit einem anderen Zeichen als "\" und ist relativ zum Schlüssel, der vom RootObject-Element angegeben wird.

RootObject

Zeiger auf das Registrierungsschlüsselobjekt, das als Stamm für den vom CompleteName-Member angegebenen Pfad dient.

ObjectType

Das ObjectType-Element ist für die interne Verwendung reserviert. Treiber dürfen nicht auf diesen Member zugreifen.

CreateOptions

Ein bitweises OR von Flags. Weitere Informationen zu diesen Flags finden Sie im CreateOptions-Parameter der ZwCreateKey-Routine .

Class

Ein Zeiger auf eine UNICODE_STRING Struktur, die die Objektklasse des Schlüssels identifiziert. Weitere Informationen zu diesem Member finden Sie im Class-Parameter der ZwCreateKey-Routine .

SecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , die Sicherheitsinformationen für das Schlüsselobjekt enthält.

SecurityQualityOfService

Ein Zeiger auf eine SECURITY_QUALITY_OF_SERVICE-Struktur , die in Winnt.h definiert ist.

DesiredAccess

Die Zugriffsmaske, die vom Thread angegeben wurde, der versucht, den Registrierungsschlüssel zu erstellen.

GrantedAccess

Eine Zugriffsmaske, die die Zugriffsrechte angibt, die dem Thread gewährt wurden, der versucht, den Registrierungsschlüssel zu erstellen. Weitere Informationen zu diesem Member finden Sie unter Hinweise.

Disposition

Ein Wert, der angibt, ob der Registrierungsschlüssel erstellt wurde. Weitere Informationen zu diesem Member finden Sie im Disposition-Parameter der ZwCreateKey-Routine und im folgenden Abschnitt Hinweise.

ResultObject

Ein Zeiger auf einen Speicherort, der die Adresse des Schlüsselobjekts empfängt, das den erstellten Registrierungsschlüssel darstellt. Weitere Informationen zu diesem Member finden Sie unter Hinweise.

CallContext

Optionale vom Treiber definierte Kontextinformationen, die die RegistryCallback-Routine des Treibers bereitstellen kann.

RootObjectContext

Ein Zeiger auf eine vom Treiber definierte Kontextinformation, die der Treiber dem Stamm des Pfads für das Registrierungsobjekt zugeordnet hat, indem CmSetCallbackObjectContext aufgerufen wird.

Transaction

Ein Zeiger auf ein Transaktionsobjekt, für das der Vorgang versucht wird. Wenn dieser Member NULL ist, wird der Vorgang im Nichttransaktionskontext ausgeführt.

Reserved

Wenn dieser Member 1 ist, können Sie diese Struktur sicher in den Typ REG_CREATE_KEY_INFORMATION_V1 umwandeln, der zusätzliche Parameter enthält.

Hinweise

Der Konfigurations-Manager übergibt diese Struktur jedes Mal an die RegistryCallback-Routine , wenn ein Thread versucht, einen Schlüssel zu erstellen, z. B. wenn ein Benutzermodusthread RegCreateKey oder RegCreateKeyEx aufruft oder wenn ein Treiber ZwCreateKey aufruft.

Wenn die RegistryCallback-Routine des Treibers STATUS_CALLBACK_BYPASS für eine RegNtPreCreateKeyEx-Benachrichtigung zurückgibt, muss der Treiber die Werte GrantedAccess, Disposition und ResultObject angeben.

Weitere Informationen zu Registrierungsfiltervorgängen finden Sie unter Filtern von Registrierungsaufrufen.