Função BuildExplicitAccessWithNameW (aclapi.h)
A função BuildExplicitAccessWithName inicializa uma estrutura EXPLICIT_ACCESS com dados especificados pelo chamador. O administrador é identificado por uma cadeia de caracteres de nome.
Sintaxe
void BuildExplicitAccessWithNameW(
[in, out] PEXPLICIT_ACCESS_W pExplicitAccess,
[in, optional] LPWSTR pTrusteeName,
[in] DWORD AccessPermissions,
[in] ACCESS_MODE AccessMode,
[in] DWORD Inheritance
);
Parâmetros
[in, out] pExplicitAccess
Um ponteiro para uma estrutura EXPLICIT_ACCESS a ser inicializada. A função BuildExplicitAccessWithName não aloca nenhuma memória. Esse parâmetro não pode ser NULL.
[in, optional] pTrusteeName
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do administrador do membro ptstrName da estrutura TRUSTEE . A função BuildExplicitAccessWithName define os outros membros da estrutura TRUSTEE da seguinte maneira.
Valor | Significado |
---|---|
|
NULL |
|
NO_MULTIPLE_TRUSTEE |
|
TRUSTEE_IS_NAME |
|
TRUSTEE_IS_UNKNOWN |
[in] AccessPermissions
Especifica uma máscara de acesso para o membro grfAccessPermissions da estrutura EXPLICIT_ACCESS . A máscara é um conjunto de sinalizadores de bits que usam o formato ACCESS_MASK para especificar os direitos de acesso que uma ACE permite, nega ou audita para o administrador. As funções que usam a estrutura EXPLICIT_ACCESS não convertem, interpretam ou validam os bits nessa máscara.
[in] AccessMode
Especifica um modo de acesso para o membro grfAccessMode da estrutura EXPLICIT_ACCESS . O modo de acesso indica se a ACE ( entrada de controle de acesso ) permite, nega ou audita os direitos especificados. Para uma DACL ( lista de controle de acesso discricionário ), esse parâmetro pode ser um dos valores da enumeração ACCESS_MODE . Para uma SACL ( lista de controle de acesso do sistema ), esse parâmetro pode ser uma combinação de valores ACCESS_MODE .
[in] Inheritance
Especifica um tipo de herança para o membro grfInheritance da estrutura EXPLICIT_ACCESS . Esse valor é um conjunto de sinalizadores de bits que determinam se outros contêineres ou objetos podem herdar o ACE do objeto primário ao qual a ACL está anexada. O valor desse membro corresponde à parte de herança (byte de baixa ordem) do membro AceFlags da estrutura ACE_HEADER . Esse parâmetro pode ser NO_INHERITANCE para indicar que o ACE não é herdável ou pode ser uma combinação dos valores a seguir.
Retornar valor
Nenhum
Comentários
Observação
O cabeçalho aclapi.h define BuildExplicitAccessWithName 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 |
Confira também
Visão geral do Controle de Acesso