共用方式為


IRP_MJ_QUERY_SECURITY等位的FLT_PARAMETERS

作業之FLT_IO_PARAMETER_BLOCK結構的 MajorFunction 字段IRP_MJ_QUERY_SECURITY時使用的等位元件。

語法

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    SECURITY_INFORMATION    SecurityInformation;
    ULONG POINTER_ALIGNMENT Length;
    PVOID                   SecurityBuffer;
    PDML                    MdlAddress;
  } QuerySecurity;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

成員

  • QuerySecurity:包含下列成員的結構。

  • SecurityInformation:所提供呼叫端 SECURITY_INFORMATION 值的指標,指定要查詢的安全性資訊。 下列其中之一:

    SecurityInformation 值 意義
    OWNER_SECURITY_INFORMATION 正在查詢對象的擁有者識別碼。 需要READ_CONTROL存取權。
    GROUP_SECURITY_INFORMATION 正在查詢物件的主要群組標識碼。 需要READ_CONTROL存取權。
    DACL_SECURITY_INFORMATION 正在查詢物件的任意訪問控制清單 (DACL) 。 需要READ_CONTROL存取權。
    SACL_SECURITY_INFORMATION 正在查詢對象的系統 ACL (SACL) 。 需要ACCESS_SYSTEM_SECURITY存取權。
  • 長度SecurityBuffer 指向的緩衝區長度,以位元組為單位。

  • SecurityBuffer:呼叫端提供的輸出緩衝區指標,該緩衝區會接收指定物件之安全性描述元的複本。 呼叫進程必須具有許可權,才能檢視物件安全性狀態的指定層面。 SECURITY_DESCRIPTOR 結構會以自我相對格式傳回。 如果 MdlAddress 中提供 MDL,這個成員是選擇性的,而且可以是 NULL。 請參閱備註

  • MdlAddress:描述 SecurityBuffer 所指向之緩衝區的記憶體描述項列表位址 (MDL) 。 如果 SecurityBuffer 中提供緩衝區,這個成員是選擇性的,而且可以是 NULL。 請參閱備註

備註

IRP_MJ_QUERY_SECURITY作業的FLT_PARAMETERS結構包含回呼數據所代表之 IRP 型查詢安全性資訊作業的參數 (FLT_CALLBACK_DATA) 結構。 它包含在 FLT_IO_PARAMETER_BLOCK 結構中。

如果同時提供 SecurityBufferMdlAddress 緩衝區,建議迷你篩選器使用 MDL。 當 SecurityBuffer 是在呼叫進程內容中存取的使用者模式位址時,或如果它是核心模式位址, 則 SecurityBuffer 所指向的記憶體是有效的。

如果迷你篩選程序變更 MdlAddress 的值,則在後續作業回呼之後,篩選管理員會釋放目前儲存在 MdlAddress 中的 MDL ,並還原先前的 MdlAddress 值。

在 Windows XP 和更新版本上,FLT_IO_PARAMETER_BLOCK 結構之 TargetFileObject 成員指向的物件可以代表具名數據流。 如需具名數據流的詳細資訊,請參閱 FILE_STREAM_INFORMATION

IRP_MJ_QUERY_SECURITY是以 IRP 為基礎的作業。

規格需求

需求類型 需求
標頭 Fltkernel.h (包括 Fltkernel.h)

另請參閱

FILE_STREAM_INFORMATION

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FLT_PARAMETERS

IRP_MJ_QUERY_SECURITY

SECURITY_DESCRIPTOR

SECURITY_INFORMATION