setUserObjectSecurity 函式 (winuser.h)

SetUserObjectSecurity 函式會設定用戶對象的安全性。例如，這可以是視窗或 DDE 交談。

語法

BOOL SetUserObjectSecurity(
  [in] HANDLE                hObj,
  [in] PSECURITY_INFORMATION pSIRequested,
  [in] PSECURITY_DESCRIPTOR  pSID
);

[in] hObj

設定安全性資訊之用戶物件的句柄。

[in] pSIRequested

值的指標，表示要設定之安全描述元的元件。此參數可以是下列值的組合。

值	意義
DACL_SECURITY_INFORMATION	設定物件的 DACL) (任意存取控制清單。 hObj 指定的句柄必須具有WRITE_DAC存取權，否則呼叫進程必須是對象的擁有者。
GROUP_SECURITY_INFORMATION	設定物件 (SID) 的主要群組安全組標識碼。
OWNER_SECURITY_INFORMATION	設定物件的擁有者 SID。 hObj 指定的句柄必須具有WRITE_OWNER存取權，或者呼叫進程必須是對象的擁有者，或已啟用SE_TAKE_OWNERSHIP_NAME許可權。
SACL_SECURITY_INFORMATION	設定物件的系統存取控制清單 (SACL) 。 hObj 指定的句柄必須具有ACCESS_SYSTEM_SECURITY存取權。若要取得ACCESS_SYSTEM_SECURITY存取權在呼叫端的目前存取令牌中啟用SE_SECURITY_NAME許可權。開啟ACCESS_SYSTEM_SECURITY存取句柄。停用許可權。

[in] pSID

包含新安全性資訊的 SECURITY_DESCRIPTOR 結構的指標。

此緩衝區必須對齊 4 位元組界限。

如果函式成功，函式會傳回非零。

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

SetUserObjectSecurity 函式會將安全性描述符中指定的變更套用至指派給用戶物件的安全性描述元。對象的安全性描述元必須以自我相對形式表示。如有必要，此函式會配置額外的記憶體，以增加安全性描述元的大小。

如需使用此函式的範例，請參閱啟動互動式用戶端程式。