Função BuildTrusteeWithObjectsAndNameW (aclapi.h)

Artigo
02/23/2024

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

Sintaxe

void BuildTrusteeWithObjectsAndNameW(
  [in, out]      PTRUSTEE_W          pTrustee,
  [in, optional] POBJECTS_AND_NAME_W pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPWSTR              ObjectTypeName,
  [in, optional] LPWSTR              InheritedObjectTypeName,
  [in, optional] LPWSTR              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 objeto protegível 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 objeto de confiança.

Retornar valor

Nenhum

Comentários

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íficos do objeto.

Observação

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. 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]
Plataforma de Destino	Windows
Cabeçalho	aclapi.h
Biblioteca	Advapi32.lib
DLL	Advapi32.dll