SetSecurityDescriptorControl 函式 (securitybaseapi.h)

發行項
08/25/2023

SetSecurityDescriptorControl函式會設定安全性描述元的控制位。函式只能設定與 ACE 自動繼承相關的控制位。若要設定安全性描述元的其他控制位，請使用 SetSecurityDescriptorDacl等函式來修改安全性描述元的元件。

語法

BOOL SetSecurityDescriptorControl(
  [in] PSECURITY_DESCRIPTOR        pSecurityDescriptor,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);

參數

[in] pSecurityDescriptor

設定控制項和修訂資訊的 SECURITY_DESCRIPTOR 結構的指標。

[in] ControlBitsOfInterest

SECURITY_DESCRIPTOR_CONTROL遮罩，表示要設定的控制位。

[in] ControlBitsToSet

SECURITY_DESCRIPTOR_CONTROL遮罩，指出ControlBitsOfInterest遮罩所指定之控制項位的新值。

傳回值

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

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

備註

SetSecurityDescriptorControl函式會指定要修改的控制項位或位，以及位是否開啟或關閉。

範例

下列範例會將安全性描述元上的 DACL 標示為受保護。

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, SE_DACL_PROTECTED );

下列範例會將 DACL 標示為未受保護。

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, 0 );

需求


最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	securitybaseapi.h (包括 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll