REG_SET_VALUE_KEY_INFORMATION 結構 (wdm.h)

REG_SET_VALUE_KEY_INFORMATION 結構描述登錄機碼值專案的新設定。

語法

typedef struct _REG_SET_VALUE_KEY_INFORMATION {
  PVOID           Object;
  PUNICODE_STRING ValueName;
  ULONG           TitleIndex;
  ULONG           Type;
  PVOID           Data;
  ULONG           DataSize;
  PVOID           CallContext;
  PVOID           ObjectContext;
  PVOID           Reserved;
} REG_SET_VALUE_KEY_INFORMATION, *PREG_SET_VALUE_KEY_INFORMATION;

成員

Object

要變更其值專案即將變更之機碼的登錄機碼物件的指標。

ValueName

UNICODE_STRING 結構的指標，其中包含即將變更的值項目名稱。

TitleIndex

保留供系統使用。 驅動程式應該忽略這個成員。

Type

即將寫入的數據類型。 如需此成員可能值的詳細資訊，請參閱 ZwSetValueKey 的 Type 參數。

Data

緩衝區的指標，其中包含即將寫入的數據。 緩衝區的格式取決於 Type 的值。 如需詳細資訊，請參閱 ZwSetValueKey。

DataSize

數據緩衝區的大小，以位元組為單位。

CallContext

驅動程式的 RegistryCallback 例程可以提供的選擇性驅動程式定義內容資訊。 此成員是針對 Windows Vista 和更新版本的 Windows 作業系統所定義。

ObjectContext

驅動程式定義內容資訊的指標，此指標會呼叫 CmSetCallbackObjectContext，讓驅動程式與登錄對象相關聯。 此成員是針對 Windows Vista 和更新版本的 Windows 作業系統所定義。

Reserved

這個成員保留供未來使用。 此成員是針對 Windows Vista 和更新版本的 Windows 作業系統所定義。

備註

每次線程嘗試設定機碼的值專案時，系統會將此結構傳遞至 RegistryCallback 例程，例如，當使用者模式線程呼叫 RegSetValue 或 RegSetValueEx 或驅動程式呼叫 ZwSetValueKey 時。

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

規格需求

需求	值
最低支援的用戶端	可在 Microsoft Windows XP 和更新版本的 Windows 作業系統上使用。
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另請參閱

CmSetCallbackObjectContext

RegistryCallback

ZwSetValueKey