Funzione NetDfsGetSecurity (lmdfs.h)

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

Sintassi

NET_API_STATUS NET_API_FUNCTION NetDfsGetSecurity(
  [in]  LPWSTR               DfsEntryPath,
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] LPDWORD              lpcbSecurityDescriptor
);

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 recuperare dall'oggetto radice.

[out] ppSecurityDescriptor

Puntatore a un elenco di strutture SECURITY_DESCRIPTOR che contengono gli elementi di sicurezza richiesti nel parametro SecurityInformation .

[out] lpcbSecurityDescriptor

Dimensioni del buffer a cui punta ppSecurityDescriptor , in byte.

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 recuperato dall'oggetto "CN=DomDfsName,CN=DFS-Configuration,CN=System,DC=domain" in Active Directory dal 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 recuperato dall'oggetto specificato dalla voce del Registro di sistema HKLM\Software\Microsoft\Dfs\Standalone\<root-name> .

Requisiti

Vedi anche

Funzioni DFS (Distributed File System)

NetDfsSetSecurity

Funzioni di gestione di rete

Panoramica della gestione della rete