Função BuildTrusteeWithObjectsAndNameA (aclapi.h)
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 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.
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íficos 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 de 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 |