Funzione NetDfsSetSecurity (lmdfs.h)

Imposta il descrittore di sicurezza per l'oggetto radice dello spazio dei nomi DFS specificato.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetDfsSetSecurity(
  [in] LPWSTR               DfsEntryPath,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parametri

[in] DfsEntryPath

Puntatore a una stringa che specifica il percorso UNC (Universal Naming Convention) di una radice dello spazio dei nomi DFS.

La stringa può essere in una delle due forme. Il primo modulo è il seguente:

\\ Nomeserver\DfsName

dove ServerName è il nome del server di destinazione radice che ospita lo spazio dei nomi DFS autonomo e Dfsname è il nome dello spazio dei nomi DFS.

Il secondo formato è il seguente:

\\ Domainname\DomDfsName

dove DomainName è il nome del dominio che ospita lo spazio dei nomi DFS basato su dominio e DomDfsName è il nome dello spazio dei nomi DFS.

[in] SecurityInformation

SECURITY_INFORMATION struttura che contiene flag di bit che indicano il tipo di informazioni di sicurezza da impostare sull'oggetto radice.

[in] pSecurityDescriptor

SECURITY_DESCRIPTOR struttura che contiene il descrittore di sicurezza da impostare come specificato nel parametro SecurityInformation .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NERR_Success.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco dei codici di errore, vedere Codici errore di sistema.

Commenti

Per gli spazi dei nomi DFS basati su dominio, il descrittore di sicurezza viene impostato sull'oggetto "CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain" in Active Directory nel controller di dominio primario (PDC) del dominio che ospita lo spazio dei nomi DFS, dove <DomDfsName> è il nome dello spazio dei nomi DFS basato su dominio e <dominio> è il nome distinto del dominio Active Directory che ospita lo spazio dei nomi.

Per le radici autonome, il descrittore di sicurezza viene impostato sull'oggetto specificato dalla voce HKLM\Software\Microsoft\Dfs\Standalone\<root-name> registry .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008, Windows Server 2008
Piattaforma di destinazione Windows
Intestazione lmdfs.h (include LmDfs.h, Lm.h)
Libreria Netapi32.lib
DLL Netapi32.dll

Vedi anche

Funzioni DFS (Distributed File System)

NetDfsGetSecurity

Funzioni di gestione di rete

Panoramica della gestione della rete