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 |