GetSecurityDescriptorControl 函式 (securitybaseapi.h)

發行項
03/01/2024

GetSecurityDescriptorControl 函式會擷取安全性描述項控件和修訂資訊。

語法

BOOL GetSecurityDescriptorControl(
  [in]  PSECURITY_DESCRIPTOR         pSecurityDescriptor,
  [out] PSECURITY_DESCRIPTOR_CONTROL pControl,
  [out] LPDWORD                      lpdwRevision
);

參數

[in] pSecurityDescriptor

函式所擷取其控件和修訂資訊的 SECURITY_DESCRIPTOR 結構的指標。

[out] pControl

接收安全性描述項控制資訊之SECURITY_DESCRIPTOR_CONTROL 結構的指標。

[out] lpdwRevision

接收安全性描述項修訂值的變數指標。此值一律設定，即使 GetSecurityDescriptorControl 傳回錯誤也一樣。

傳回值

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

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

規格需求

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