estrutura TRUSTEE_A (accctrl.h)

Artigo
11/20/2024

A estrutura TRUSTEE identifica a conta de usuário, a conta de grupo ou sessão de logon à qual uma ACE ( entrada de controle de acesso ) se aplica. A estrutura pode usar um nome ou um SID (identificador de segurança) para identificar o administrador.

Funções de controle de acesso, como SetEntriesInAcl e GetExplicitEntriesFromAcl, usam essa estrutura para identificar a conta de logon associada ao controle de acesso ou às informações de controle de auditoria em uma estrutura EXPLICIT_ACCESS.

Sintaxe

typedef struct _TRUSTEE_A {
  struct _TRUSTEE_A          *pMultipleTrustee;
  MULTIPLE_TRUSTEE_OPERATION MultipleTrusteeOperation;
  TRUSTEE_FORM               TrusteeForm;
  TRUSTEE_TYPE               TrusteeType;
  union {
    LPSTR              ptstrName;
    SID                *pSid;
    OBJECTS_AND_SID    *pObjectsAndSid;
    OBJECTS_AND_NAME_A *pObjectsAndName;
  };
  LPCH                       ptstrName;
} TRUSTEE_A, *PTRUSTEE_A, TRUSTEEA, *PTRUSTEEA;

Membros

pMultipleTrustee

Um ponteiro para uma estrutura TRUSTEE que identifica uma conta de servidor que pode representar o usuário identificado pelo membro ptstrName. No momento, não há suporte para esse membro e deve ser NULL.

MultipleTrusteeOperation

Um valor do tipo de enumeração MULTIPLE_TRUSTEE_OPERATION. Atualmente, esse membro deve ser NO_MULTIPLE_TRUSTEE.

TrusteeForm

Um valor do tipo de enumeração TRUSTEE_FORM que indica o tipo de dados apontado pelo membro ptstrName.

TrusteeType

Um valor do tipo de enumeração TRUSTEE_TYPE que indica se o administrador é uma conta de usuário, uma conta de grupo ou um tipo de conta desconhecido.

ptstrName

Um ponteiro para um buffer que identifica o administrador e, opcionalmente, contém informações sobre ACEs específicas do objeto. O tipo de dados depende do valor do membro TrusteeForm.

Esse membro pode ser um dos seguintes valores.

Valor	Significado
TRUSTEE_IS_NAME	Um ponteiro para um cadeia de caracteresterminada nula que contém o nome do administrador.
TRUSTEE_IS_OBJECTS_AND_NAME	Um ponteiro para uma estrutura OBJECTS_AND_NAME que contém o nome do administrador e os nomes dos tipos de objeto em um ACE específico do objeto.
TRUSTEE_IS_OBJECTS_AND_SID	Um ponteiro para uma estrutura OBJECTS_AND_SID que contém o SID do administrador e os GUIDs dos tipos de objeto em um ACE específico do objeto.
TRUSTEE_IS_SID	Ponteiro para o SID do administrador.

pSid

pObjectsAndSid

pObjectsAndName

Observações

Um nome de administrador pode ter qualquer um dos seguintes formatos:

Um nome totalmente qualificado, como "g:\remotedir\abc".
Uma conta de domínio, como "domain1\xyz".
Um dos nomes de grupo predefinidos, como "EVERYONE" ou "GUEST".

Um dos nomes especiais a seguir.

Nome	Significado
GRUPO DE CRIADORES	O SID CREATOR_GROUP é um SID usado em ACEs herdáveis. Quando um novo objeto é criado, o sistema substitui esse SID pelo SID do grupo primário do usuário que criou o objeto.
PROPRIETÁRIO DO CRIADOR	O SID CREATOR_OWNER é um SID usado em ACEs herdáveis. Quando um novo objeto é criado, o sistema substitui esse SID pelo SID do usuário que criou o objeto.
CURRENT_USER	O proprietário do thread de chamada ou processo.

Um SID de administrador pode ser qualquer SID de usuário ou grupo. Também pode ser qualquer um dos SIDs universais e conhecidos. Para obter mais informações, consulte Identificadores de Segurança.

Nota

O cabeçalho accctrl.h define TRUSTEE_ como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	accctrl.h