REG_CREATE_KEY_INFORMATION Struktur (wdm.h)

Artikel
02/07/2025

Obsolet. 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 können, 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;

Angehörige

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 Member den \REGISTRY Schlüssel an, der das Stammverzeichnis der Registrierungsstruktur ist. Wenn der Pfad relativ ist, beginnt der Pfad mit einem anderen Zeichen als "\" und ist relativ zum Schlüssel, der vom RootObject-Element-Element angegeben wird.

RootObject

Zeigen Sie auf das Registrierungsschlüsselobjekt, das als Stamm für den pfad dient, der durch das Element CompleteName angegeben wird.

ObjectType

Das ObjectType Member ist für die interne Verwendung reserviert. Treiber dürfen nicht auf dieses Mitglied zugreifen.

CreateOptions

Ein bitweises ODER 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

Das Zugriffsformat, das vom Thread angegeben wurde, der versucht, den Registrierungsschlüssel zu erstellen.

GrantedAccess

Ein Zugriffsformat, das die Zugriffsrechte angibt, die dem Thread gewährt wurden, der versucht, den Registrierungsschlüssel zu erstellen. Weitere Informationen zu diesem Mitglied finden Sie in den Anmerkungen.

Disposition

Ein Wert, der angibt, ob der Registrierungsschlüssel erstellt wurde. Weitere Informationen zu diesem Element 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 Mitglied finden Sie in den Anmerkungen.

CallContext

Optionale treiberdefinierte Kontextinformationen, die die RegistryCallback Routine des Treibers bereitstellen können.

RootObjectContext

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

Transaction

Ein Zeiger auf ein Transaktionsobjekt, für das der Vorgang versucht wird. Wenn dieses Element NULL-ist, wird der Vorgang im kontextfremden Kontext ausgeführt.

Reserved

Wenn dieses Element 1 ist, ist es sicher, diese Struktur in den Typ REG_CREATE_KEY_INFORMATION_V1zu umwandeln, der zusätzliche Parameter enthält.

Bemerkungen

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

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

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