SeValidSecurityDescriptor 函式 (wdm.h)
SeValidSecurityDescriptor 例程會傳回指定的安全性描述元是否結構有效。
語法
BOOLEAN SeValidSecurityDescriptor(
[in] ULONG Length,
[in] PSECURITY_DESCRIPTOR SecurityDescriptor
);
參數
[in] Length
指定指定之安全性描述元的位元組大小。
[in] SecurityDescriptor
自我相對 SECURITY_DESCRIPTOR的指標,必須在系統空間的某處緩衝。
傳回值
如果緩衝式安全性描述元的結構有效,SeValidSecurityDescriptor 會傳回 TRUE。
備註
SeValidSecurityDescriptor 不會強制執行原則。 它只會檢查指定的安全性描述元數據格式是否正確。 特別是,它會檢查修訂資訊、自我關聯性、擁有者、對齊方式,如果有的話,SID、群組、DACL、ACL 和/或 SACL 不會溢位指定的 Length。 因此, SeValidSecurityDescriptor 的呼叫端無法假設傳回 的 TRUE 表示指定的安全性描述元一定具有有效的內容。
如果 SeValidSecurityDescriptor 傳回 TRUE,則指定的安全性描述元可以傳遞至另一個核心模式元件,因為它的結構有效。 否則,傳遞結構無效的安全性描述元,由另一個核心模式元件操作可能會造成未定義的結果,或甚至系統錯誤檢查。
若要驗證從使用者模式傳入的安全性描述元,請呼叫 RtlValidSecurityDescriptor ,而不是 SeValidSecurityDescriptor。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDDIs (storport) 、 PowerIrpDDis (wdm) |