wtypesbase.h) (SECURITY_ATTRIBUTES 结构

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

语法

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