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
SECURITY_QUALITY_OF_SERVICE 結構的指標，定義於 Winnt.h 中。
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） |