Função BuildTrusteeWithObjectsAndNameW (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 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 |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de