SeQuerySecurityDescriptorInfo 函式 (ntifs.h)

發行項
02/29/2024

SeQuerySecurityDescriptorInfo 例程會擷取物件的安全描述元複本。

語法

NTSTATUS SeQuerySecurityDescriptorInfo(
  [in]      PSECURITY_INFORMATION SecurityInformation,
  [out]     PSECURITY_DESCRIPTOR  SecurityDescriptor,
  [in, out] PULONG                Length,
  [in, out] PSECURITY_DESCRIPTOR  *ObjectsSecurityDescriptor
);

參數

[in] SecurityInformation

SECURITY_INFORMATION值的指標，指定要查詢哪些安全性資訊。

值	意義
DACL_SECURITY_INFORMATION	指出正在查詢物件的 DACL) (任意存取控制清單。需要READ_CONTROL存取權。
GROUP_SECURITY_INFORMATION	表示正在查詢物件的主要群組標識碼。需要READ_CONTROL存取權。
OWNER_SECURITY_INFORMATION	表示正在查詢對象的擁有者標識碼。需要READ_CONTROL存取權。
SACL_SECURITY_INFORMATION	表示正在查詢對象的系統 ACL (SACL) 。需要ACCESS_SYSTEM_SECURITY存取權。

[out] SecurityDescriptor

SeQuerySecurityDescriptorInfo 以自我相對格式填入指定之安全描述元複本的呼叫端配置用戶緩衝區。

[in, out] Length

變數的指標，指定 SecurityDescriptor 所指向緩衝區的大小，以位元組為單位。傳回時， SeQuerySecurityDescriptorInfo 會將此變數設定為儲存要求資訊所需的位元元組數目。

[in, out] ObjectsSecurityDescriptor

指向物件之安全描述元之指標的指標。安全性描述元必須是自我相對格式。

傳回值

傳回碼	Description
STATUS_SUCCESS	對 SeQuerySecurityDescriptorInfo 的呼叫成功。
STATUS_BUFFER_TOO_SMALL	緩衝區對於安全性描述元而言太小。沒有任何安全性資訊複製到緩衝區。

備註

安全性描述元可以是絕對或自我相對格式。絕對格式的安全性描述項包含其包含之資訊的指標，而不是包含資訊本身。自我相對格式的安全性描述項包含連續記憶體區塊中的資訊。在自我相對安全性描述元中， SECURITY_DESCRIPTOR 結構一律會啟動資訊，但安全性描述項的其他元件可以依照任何順序SECURITY_DESCRIPTOR結構。而不是使用記憶體位址，安全性描述元的元件是由安全性描述元開頭的位移來識別。當安全性描述項必須儲存在磁碟上或透過通訊協定傳輸時，這個格式非常有用。

因為安全性描述項是以自我相對格式傳回， 所以 SeQuerySecurityDescriptorInfo 的呼叫端應該將 SecurityDescriptor 參數中傳回的值轉換成類型PISECURITY_DESCRIPTOR_RELATIVE。

如需安全性和訪問控制的詳細資訊，請參閱適用於驅動程序開發人員的 Windows 安全性模型，以及 Windows SDK 中這些主題的相關文件。