ACCESS_STATE 構造体 (wdm.h)

[アーティクル]
08/08/2023

ACCESS_STATE構造体は、進行中のアクセスの状態を表します。これには、オブジェクトのサブジェクトコンテキスト、残りの必要なアクセスの種類、付与されたアクセスの種類、および必要に応じて、アクセスを許可するために使用された特権を示す特権セットが含まれています。

ドライバーは、ACCESS_STATE構造を直接変更する必要はありません。この構造体を作成して操作するには、「関連項目」セクションに記載されているサポートルーチンを使用します。

構文

typedef struct _ACCESS_STATE {
  LUID                     OperationID;
  BOOLEAN                  SecurityEvaluated;
  BOOLEAN                  GenerateAudit;
  BOOLEAN                  GenerateOnClose;
  BOOLEAN                  PrivilegesAllocated;
  ULONG                    Flags;
  ACCESS_MASK              RemainingDesiredAccess;
  ACCESS_MASK              PreviouslyGrantedAccess;
  ACCESS_MASK              OriginalDesiredAccess;
  SECURITY_SUBJECT_CONTEXT SubjectSecurityContext;
  PSECURITY_DESCRIPTOR     SecurityDescriptor;
  PVOID                    AuxData;
  union {
    INITIAL_PRIVILEGE_SET InitialPrivilegeSet;
    PRIVILEGE_SET         PrivilegeSet;
  } Privileges;
  BOOLEAN                  AuditPrivileges;
  UNICODE_STRING           ObjectName;
  UNICODE_STRING           ObjectTypeName;
} ACCESS_STATE, *PACCESS_STATE;

メンバー

OperationID

このアクセスに関連する操作の識別子。このメンバーは AuxData メンバーの TransactionId に置き換えられ、現在ドライバーでは使用されていません。

SecurityEvaluated

セキュリティがアクセスチェックの一部として評価されたかどうかを示すブール値。このメンバーは現在、ドライバーによって使用されていません。

GenerateAudit

アクセスで監査を生成するかどうかを指定するブール値。このメンバーは現在、ドライバーによって使用されていません。

GenerateOnClose

作成されるハンドルを閉じるときに監査を生成するかどうかを指定するブール値。このメンバーは現在、ドライバーによって使用されていません。

PrivilegesAllocated

アクセスチェックの一部として特権が割り当てられたかどうかを示すブール値。このメンバーは現在、ドライバーによって使用されていません。

Flags

アクセス用のビットフィールドフラグを含む 32 ビット値。ドライバーは、走査アクセスフラグ (TOKEN_HAS_TRAVERSE_PRIVILEGE) をチェックできます。走査アクセスをチェックする方法の詳細については、「IRP_MJ_CREATEでの走査特権の確認」を参照してください。ドライバーは、TOKEN_IS_RESTRICTED フラグのチェックすることもできます。これらのフラグは Ntifs.h で定義されています。

RemainingDesiredAccess

呼び出し元にまだ付与されていないアクセス権を記述するACCESS_MASK型。ドライバーは、このメンバーを使用して、Windows セキュリティシステムがアクセスを許可できるかどうかを判断します。アクセスを許可できる場合、ドライバーは必要に応じて PreviouslyGrantedAccess メンバーと RemainingDesiredAccess メンバーを更新します。

PreviouslyGrantedAccess

セキュリティ参照モニタールーチンの呼び出し元に既に付与されているアクセスに関する情報を指定するACCESS_MASK型。 Windows セキュリティシステムは、呼び出し元の特権に基づいて特定の権限を付与します。たとえば、右方向 (サブディレクトリまたはファイルを開く一部としてディレクトリを走査する機能) などです。

OriginalDesiredAccess

呼び出し元によって要求された元のアクセス権を含むACCESS_MASK型。

SubjectSecurityContext

アクセスの検証と監査に使用されるサブジェクトセキュリティコンテキストに関する情報を含むSECURITY_SUBJECT_CONTEXT構造体。

SecurityDescriptor

このアクセスが関連するオブジェクトのセキュリティ情報を含む SECURITY_DESCRIPTOR構造体へのポインター。

AuxData

アクセスの補助データを含むメモリブロックへのポインター。

Privileges

次のいずれかの構造体を含めることができる共用体。この共用体を使用すると、アクセス状態構造に 3 つの特権を埋め込めます。操作中にそれ以上の特権が必要な場合は、 AuxData メンバー拡張機能に割り当てられます。このメンバーは現在、ドライバーによって使用されていません。

Privileges.InitialPrivilegeSet

アクセスの初期特権のセットを指定するINITIAL_PRIVILEGE_SET構造体。