Funzione NetDfsAddFtRoot (lmdfs.h)

Crea un nuovo spazio dei nomi DFS (Distributed File System) basato su dominio. Se lo spazio dei nomi esiste già, la funzione aggiunge la destinazione radice specificata.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetDfsAddFtRoot(
  [in]           LPWSTR ServerName,
  [in]           LPWSTR RootShare,
  [in]           LPWSTR FtDfsName,
  [in, optional] LPWSTR Comment,
  [in]           DWORD  Flags
);

Parametri

[in] ServerName

Puntatore a una stringa che specifica il nome del server che ospiterà la nuova destinazione radice DFS. Questo valore non può essere un indirizzo IP. Questo parametro è obbligatorio.

[in] RootShare

Puntatore a una stringa che specifica il nome della cartella condivisa nel server che ospiterà la nuova destinazione radice DFS. Questo parametro è obbligatorio.

[in] FtDfsName

Puntatore a una stringa che specifica il nome dello spazio dei nomi DFS nuovo o esistente basato su dominio. Questo parametro è obbligatorio. Per motivi di compatibilità, deve specificare la stessa stringa del parametro RootShare .

[in, optional] Comment

Puntatore a una stringa contenente un commento facoltativo associato allo spazio dei nomi DFS.

[in] Flags

Questo parametro è riservato e deve essere zero.

Valore restituito

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

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

Commenti

La condivisione specificata dal parametro RootShare deve già esistere nel server che ospiterà la nuova destinazione radice DFS. Questa funzione non crea una nuova condivisione.

Il chiamante deve disporre dell'autorizzazione per aggiornare il contenitore DFS nel servizio directory e deve avere privilegi di amministratore nel server host DFS (radice).

Requisiti

   
Client minimo supportato Windows Vista
Server minimo supportato 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)

NetDfsAdd

NetDfsAddRootTarget

NetDfsAddStdRoot

NetDfsRemoveFtRoot

Funzioni di gestione della rete

Panoramica sulla gestione della rete