InitializeSecurityDescriptor 函式 (securitybaseapi.h)

發行項
08/25/2023

InitializeSecurityDescriptor函式會初始化新的安全性描述元。

語法

BOOL InitializeSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]  DWORD                dwRevision
);

參數

[out] pSecurityDescriptor

函式初始化之SECURITY_DESCRIPTOR 結構的指標。

[in] dwRevision

要指派給安全性描述元的修訂層級。此參數必須SECURITY_DESCRIPTOR_REVISION。

傳回值

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

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

備註

InitializeSecurityDescriptor函式會以絕對格式初始化安全性描述元，而不是自我相對格式。

InitializeSecurityDescriptor函式會將安全性描述元初始化為沒有系統存取控制清單 (SACL) 、沒有任意存取控制清單 (DACL) 、沒有擁有者、沒有主要群組，以及所有控制項旗標都設定為FALSE (Null) 。因此，除了其修訂層級之外，它是空的。

範例

如需使用此函式的範例，請參閱建立新物件的安全性描述元。

需求


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