REG_CREATE_KEY_INFORMATION 結構 (wdm.h)

  • 發行項

已過時。 從 Windows 7 開始，請改用 REG_CREATE_KEY_INFORMATION_V1此結構的 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，其中包含其他參數。

備註

組態管理員會在每次線程嘗試建立機碼時，將此結構傳遞至 RegistryCallback 例程，例如，當使用者模式線程呼叫 RegCreateKey 或 RegCreateKeyEx 或驅動程式呼叫 ZwCreateKey 時。

如果驅動程式的 RegistryCallback 例程傳回 RegNtPreCreateKeyEx 通知的STATUS_CALLBACK_BYPASS，驅動程式必須提供 GrantedAccess、 Disposition 和 ResultObject 值。

如需登錄篩選作業的詳細資訊，請參閱 篩選登錄呼叫。

規格需求

需求 值
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另請參閱

REG_CREATE_KEY_INFORMATION_V1

REG_POST_OPERATION_INFORMATION

RegistryCallback

SECURITY_DESCRIPTOR

UNICODE_STRING

ZwCreateKey