共用方式為


InitializeSecurityDescriptor 函式 (securitybaseapi.h)

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

另請參閱

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

低階存取控制

低階存取控制函式

SECURITY_DESCRIPTOR

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl