Funzione NetDfsAddRootTarget (lmdfs.h)

Articolo
2023-08-24

Crea uno spazio dei nomi DFS basato su dominio o autonomo oppure aggiunge una nuova destinazione radice a uno spazio dei nomi basato su dominio esistente.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetDfsAddRootTarget(
  [in]           LPWSTR pDfsPath,
  [in, optional] LPWSTR pTargetPath,
  [in]           ULONG  MajorVersion,
  [in, optional] LPWSTR pComment,
  [in]           ULONG  Flags
);

Parametri

[in] pDfsPath

Puntatore a una stringa che specifica il percorso UNIVERSAL Naming Convention (UNC) di uno spazio dei nomi DFS.

Per uno spazio dei nomi DFS autonomo, questa stringa deve essere nel formato seguente:

\\ Nomeserver\DfsName

dove ServerName è il nome del server che ospiterà la nuova destinazione radice DFS e DfsName è il nome dello spazio dei nomi DFS.

Per uno spazio dei nomi DFS basato su dominio, questa stringa deve essere nel formato 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 nuovo o esistente. Per motivi di compatibilità, DomDfsName deve corrispondere al nome della cartella condivisa nel server che ospiterà la nuova destinazione radice DFS.

[in, optional] pTargetPath

Puntatore a una stringa Unicode con terminazione null che specifica il percorso UNC di una destinazione radice DFS per lo spazio dei nomi DFS specificato nel parametro pDfsPath .

Per uno spazio dei nomi DFS autonomo, questo parametro deve essere NULL. Per uno spazio dei nomi DFS basato su dominio, la stringa deve essere nel formato seguente:

\\ Nomeserver\RootShare

dove ServerName è il nome del server che ospiterà la nuova destinazione radice DFS e RootShare è il nome della cartella condivisa nel server. La condivisione specificata da RootShare deve già esistere nel server che ospiterà la nuova destinazione radice DFS. Questa funzione non crea una nuova condivisione.

[in] MajorVersion

Specifica la versione dei metadati DFS per lo spazio dei nomi.

Nota Questo parametro è usato solo quando si crea un nuovo spazio dei nomi.

Se viene creato uno spazio dei nomi DFS autonomo, questo parametro deve essere impostato su 1.

Se viene creato uno spazio dei nomi basato su dominio, questo parametro deve essere impostato come segue:

Impostarlo su 1 per specificare la modalità Windows 2000.
Impostarlo su 2 o versione successiva per specificare la modalità Windows Server 2008.

Se viene aggiunta una nuova destinazione radice a uno spazio dei nomi DFS basato su dominio esistente, questo parametro deve essere impostato su zero.

[in, optional] pComment

Puntatore a una stringa Unicode con terminazione null contenente un commento associato alla radice DFS.

[in] Flags

Questo parametro è riservato e deve essere zero.

Valore restituito

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

Se il dominio non è a livello funzionale richiesto per l'oggetto MajorVersion specificato, il valore restituito è ERROR_DS_INCOMPATIBLE. Questo valore restituito si applica solo alle radici del dominio e a MajorVersion di 2.

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

Il chiamante deve avere privilegi di amministratore nel server DFS.

Per determinare la versione dei metadati DFS che può essere specificata nel parametro MajorVersion , usare la funzione NetDfsGetSupportedNamespaceVersion .

La tabella seguente mostra i valori dei parametri da specificare, in base al risultato desiderato.

parametro pDfsPath	parametro pTargetPath	Parametro MajorVersion	Risultato
\\DomainName\DomDfsName	\\ServerName\RootShare	1	Creare uno spazio dei nomi DFS basato su dominio in modalità Windows 2000 o aggiungere una nuova destinazione radice a una esistente.
\\DomainName\DomDfsName	\\ServerName\RootShare	2	Creare uno spazio dei nomi DFS basato su dominio in modalità Windows Server 2008 o aggiungere una nuova destinazione radice a una esistente.
\\DomainName\DomDfsName	\\ServerName\RootShare	0	Aggiungere una nuova destinazione radice a uno spazio dei nomi DFS basato su dominio esistente windows 2000 o Windows Server 2008.
\\ServerName\DfsName	NULL	Deve essere 1.	Creare uno spazio dei nomi DFS autonomo.

Requisiti

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