InitializeSecurityDescriptor 函数 (securitybaseapi.h)

InitializeSecurityDescriptor 函数初始化新的安全描述符

语法

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

parameters

[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)
Library Advapi32.lib
DLL Advapi32.dll

请参阅

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

低级别访问控制

低级别访问控制函数

SECURITY_DESCRIPTOR

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl