Compartilhar via


estrutura SECURITY_ATTRIBUTES (wtypesbase.h)

A estrutura SECURITY_ATTRIBUTES contém o descritor de segurança de um objeto e especifica se o identificador recuperado especificando essa estrutura é herdável. Essa estrutura fornece configurações de segurança para objetos criados por várias funções, como CreateFile, CreatePipe, CreateProcess, RegCreateKeyEx ou RegSaveKeyEx.

Sintaxe

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

Membros

nLength

O tamanho, em bytes, dessa estrutura. Defina esse valor como o tamanho da estrutura SECURITY_ATTRIBUTES .

lpSecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que controla o acesso ao objeto . Se o valor desse membro for NULL, o objeto será atribuído ao descritor de segurança padrão associado ao token de acesso do processo de chamada. Isso não é o mesmo que conceder acesso a todos atribuindo uma DACL (lista de controle de acesso discricionário) NULL. Por padrão, a DACL padrão no token de acesso de um processo permite o acesso somente ao usuário representado pelo token de acesso.

Para obter informações sobre como criar um descritor de segurança, consulte Criando um descritor de segurança.

bInheritHandle

Um valor booliano que especifica se o identificador retornado é herdado quando um novo processo é criado. Se esse membro for TRUE, o novo processo herdará o identificador.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Cabeçalho wtypesbase.h