Função NetDfsSetSecurity (lmdfs.h)
Define o descritor de segurança para o objeto raiz do namespace DFS especificado.
Sintaxe
NET_API_STATUS NET_API_FUNCTION NetDfsSetSecurity(
[in] LPWSTR DfsEntryPath,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
Parâmetros
[in] DfsEntryPath
Ponteiro para uma cadeia de caracteres que especifica o caminho UNC (Convenção de Nomenclatura Universal) de uma raiz de namespace do DFS.
A cadeia de caracteres pode estar em uma das duas formas. O primeiro formulário é o seguinte:
\\ Servername\DfsName
em que ServerName é o nome do servidor de destino raiz que hospeda o namespace dfs autônomo e Dfsname é o nome do namespace dfs.
O segundo formulário é o seguinte:
\\ Domainname\DomDfsName
em que DomainName é o nome do domínio que hospeda o namespace DFS baseado em domínio e DomDfsName é o nome do namespace dfs.
[in] SecurityInformation
SECURITY_INFORMATION estrutura que contém sinalizadores de bits que indicam o tipo de informações de segurança a serem definidas no objeto raiz.
[in] pSecurityDescriptor
SECURITY_DESCRIPTOR estrutura que contém o descritor de segurança a ser definido conforme especificado no parâmetro SecurityInformation .
Retornar valor
Se a função for bem-sucedida, o valor retornado será NERR_Success.
Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista de códigos de erro, consulte Códigos de erro do sistema.
Comentários
Para namespaces DFS baseados em domínio, o descritor de segurança é definido no objeto "CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain" no Active Directory no controlador de domínio primário (PDC) do domínio que hospeda o namespace do DFS, em < que DomDfsName> é o nome do namespace dfs baseado em domínio e <o domínio> é o nome diferenciado do domínio do Active Directory que hospeda o namespace.
Para raízes autônomas, o descritor de segurança é definido no objeto especificado pela entrada do registro denome> raiz autônomo<\ do Software HKLM\\Microsoft\Dfs\.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008, Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | lmdfs.h (inclua LmDfs.h, Lm.h) |
| Biblioteca | Netapi32.lib |
| DLL | Netapi32.dll |
Confira também
Funções do DFS (Sistema de Arquivos Distribuídos)