estrutura TRUSTEE_A (accctrl.h)

Artigo
02/23/2024

A estrutura TRUSTEE identifica a conta de usuário, a conta de grupo ou a 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 objeto de confiança.

As 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 objeto de confiança é uma conta de usuário, uma conta de grupo ou um tipo de conta desconhecido.

ptstrName

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

Esse membro pode ser um dos valores a seguir.

Valor	Significado
TRUSTEE_IS_NAME	Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do objeto de confiança.
TRUSTEE_IS_OBJECTS_AND_NAME	Um ponteiro para uma estrutura OBJECTS_AND_NAME que contém o nome do objeto de confiança e os nomes dos tipos de objeto em uma ACE específica do objeto.
TRUSTEE_IS_OBJECTS_AND_SID	Um ponteiro para uma estrutura OBJECTS_AND_SID que contém o SID do objeto de confiança e os GUIDs dos tipos de objeto em uma ACE específica do objeto.
TRUSTEE_IS_SID	Ponteiro para o SID do administrador.

pSid

pObjectsAndSid

pObjectsAndName

Comentários

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 CRIADOR	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.
CREATOR OWNER	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 ou processo de chamada.

Um SID de confiança 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.

Observação

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. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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