editSecurity 函式 (aclui.h)

EditSecurity 函式會顯示包含基本安全性屬性頁的屬性表。此屬性頁可讓用戶檢視和編輯物件 DACL 中 ACE 所允許或拒絕的訪問許可權。

語法

BOOL ACLUIAPI EditSecurity(
  [in] HWND           hwndOwner,
  [in] LPSECURITYINFO psi
);

[in] hwndOwner

擁有屬性表之視窗的句柄。此參數可以是 Null。

[in] psi

ISecurityInformation 介面實作的指標。系統會呼叫介面方法來擷取所編輯物件的相關信息，並傳回用戶的輸入。

如果函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

EditSecurity 函式會呼叫 CreateSecurityPage 函式來建立基本安全性屬性頁。

在屬性頁初始化期間，系統會呼叫 ISecurityInformation：：GetSecurity 和 ISecurityInformation：：SetSecurity 方法來判斷使用者是否有權編輯物件的安全性描述元。如果使用者沒有許可權，系統會顯示錯誤訊息。

基本安全性屬性頁可以包含 [ 進階 ] 按鈕，以顯示進階安全性屬性表。這個進階安全性屬性表可以包含三個額外的屬性頁，讓用戶能夠檢視和編輯物件的 DACL、SACL 和擁有者。