Função BuildTrusteeWithObjectsAndNameA (aclapi.h)

Artigo
11/20/2024

A função BuildTrusteeWithObjectsAndName inicializa uma estrutura COM as informações específicas do objeto de entrada de controle de acesso (ACE) e inicializa os membros restantes da estrutura para valores padrão. O chamador também especifica o nome do administrador.

Sintaxe

void BuildTrusteeWithObjectsAndNameA(
  [in, out]      PTRUSTEE_A          pTrustee,
  [in, optional] POBJECTS_AND_NAME_A pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPSTR               ObjectTypeName,
  [in, optional] LPSTR               InheritedObjectTypeName,
  [in, optional] LPSTR               Name
);

Parâmetros

[in, out] pTrustee

Um ponteiro para uma estrutura TRUSTEE que será inicializada por essa função. Se o valor desse parâmetro for NULL ou um ponteiro que não seja válido, os resultados serão indefinidos.

[in, optional] pObjName

Um ponteiro para uma estrutura OBJECTS_AND_NAME que contém informações sobre o administrador e o objeto protegível.

[in, optional] ObjectType

Um ponteiro para uma enumeração SE_OBJECT_TYPE que contém informações sobre o tipo de objeto protegível.

[in, optional] ObjectTypeName

Um ponteiro para uma cadeia de caracteres que especifica o nome que corresponde ao GUID objectType a ser adicionado à estrutura TRUSTEE retornada no parâmetro pTrustee . Essa função determina o GUID ObjectType que corresponde a esse nome.

[in, optional] InheritedObjectTypeName

Um ponteiro para uma cadeia de caracteres que especifica o nome que corresponde ao GUID InheritedObjectType a ser adicionado à estrutura TRUSTEE retornada no parâmetro pTrustee. Essa função determina o GUID InheritedObjectType que corresponde a esse nome.

[in, optional] Name

Um ponteiro para uma cadeia de caracteres que especifica o nome usado para identificar o administrador.

Valor de retorno

Nenhum

Observações

Essa função não aloca memória para as estruturas TRUSTEE e OBJECTS_AND_NAME.

Para obter mais informações sobre ACEs específicas do objeto, consulte ACEs específicas do objeto.

Nota

O cabeçalho aclapi.h define BuildTrusteeWithObjectsAndName 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]
da Plataforma de Destino	Windows
cabeçalho	aclapi.h
biblioteca	Advapi32.lib
de DLL	Advapi32.dll