estrutura SECURITY_DESCRIPTOR (winnt.h)

Artigo
03/13/2024

A estrutura SECURITY_DESCRIPTOR contém as informações de segurança associadas a um objeto . Os aplicativos usam essa estrutura para definir e consultar o status de segurança de um objeto.

Como o formato interno de um descritor de segurança pode variar, recomendamos que os aplicativos não modifiquem a estrutura SECURITY_DESCRIPTOR diretamente. Para criar e manipular um descritor de segurança, use as funções listadas em Consulte também.

Sintaxe

typedef struct _SECURITY_DESCRIPTOR {
  BYTE                        Revision;
  BYTE                        Sbz1;
  SECURITY_DESCRIPTOR_CONTROL Control;
  PSID                        Owner;
  PSID                        Group;
  PACL                        Sacl;
  PACL                        Dacl;
} SECURITY_DESCRIPTOR, *PISECURITY_DESCRIPTOR;

Membros

Revision

Sbz1

Control

Owner

Group

Sacl

Dacl

Comentários

Um descritor de segurança inclui informações que especificam os seguintes componentes da segurança de um objeto:

Um SID ( identificador de segurança do proprietário)
Um SID de grupo primário
Uma DACL (lista de controle de acesso discricionário )
Uma SACL ( lista de controle de acesso do sistema )
Qualificadores para os itens anteriores

Várias funções que usam a estrutura SECURITY_DESCRIPTOR exigem que essa estrutura seja alinhada em um limite de ponteiro válido na memória. Esses limites variam dependendo do tipo de processador usado. Funções de alocação de memória, como malloc e LocalAlloc , retornam ponteiros alinhados corretamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Cabeçalho	winnt.h (inclua Windows.h)