SetKernelObjectSecurity 函式 (securitybaseapi.h)

發行項
03/01/2024

SetKernelObjectSecurity 函式會設定核心對象的安全性。例如，這可以是進程、線程或事件。

注意在檔案系統對象上設定安全性描述項時，不應該使用這個函式。請改用 SetSecurityInfo 或 SetNamedSecurityInfo 函式。

語法

BOOL SetKernelObjectSecurity(
  [in] HANDLE               Handle,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR SecurityDescriptor
);

參數

[in] Handle

設定安全性資訊之核心物件的句柄。

[in] SecurityInformation

一組位旗標，表示要設定的安全性信息類型。這個參數可以是 SECURITY_INFORMATION 位旗標的組合。

[in] SecurityDescriptor

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

傳回值

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

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

規格需求

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