wtypesbase.h) (SECURITY_ATTRIBUTES 结构

SECURITY_ATTRIBUTES 结构包含对象的安全描述符,并指定通过指定此结构检索的句柄是否可继承。 此结构为由各种函数(如 CreateFileCreatePipeCreateProcessRegCreateKeyExRegSaveKeyEx)创建的对象提供安全设置。

语法

typedef struct _SECURITY_ATTRIBUTES {
  DWORD  nLength;
  LPVOID lpSecurityDescriptor;
  BOOL   bInheritHandle;
} SECURITY_ATTRIBUTES, *PSECURITY_ATTRIBUTES, *LPSECURITY_ATTRIBUTES;

成员

nLength

此结构的大小(以字节为单位)。 将此值设置为 SECURITY_ATTRIBUTES 结构的大小。

lpSecurityDescriptor

指向 SECURITY_DESCRIPTOR 结构的指针,该结构控制对 对象的访问。 如果此成员的值为 NULL,则为对象分配与调用进程的 访问令牌 关联的默认安全描述符。 这与通过分配 NULL自由访问控制列表 (DACL) 向所有人授予访问权限不同。 默认情况下,进程的访问令牌中的默认 DACL 仅允许访问令牌表示的用户。

有关创建安全描述符的信息,请参阅 创建安全描述符

bInheritHandle

一个布尔值,指定是否在创建新进程时继承返回的句柄。 如果此成员为 TRUE,则新进程将继承句柄。

要求

要求
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
标头 wtypesbase.h