Funzione NetDfsRemoveRootTarget (lmdfs.h)

Rimuove una destinazione radice DFS da uno spazio dei nomi DFS basato su dominio. Se la destinazione radice è l'ultima destinazione radice nello spazio dei nomi DFS, questa funzione rimuove lo spazio dei nomi DFS. Questa funzione può essere usata anche per rimuovere uno spazio dei nomi DFS autonomo.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetDfsRemoveRootTarget(
  [in]           LPWSTR pDfsPath,
  [in, optional] LPWSTR pTargetPath,
  [in]           ULONG  Flags
);

Parametri

[in] pDfsPath

Puntatore a una stringa che specifica il percorso UNC (Universal Naming Convention) 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 ospita la 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.

[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 ospita la destinazione radice DFS e RootShare è il nome della cartella nel server.

[in] Flags

Flag che specifica il tipo di operazione di rimozione. Per uno spazio dei nomi DFS autonomo, questo parametro deve essere zero. Per uno spazio dei nomi DFS basato su dominio, può essere zero o il valore seguente. Se è zero, indica una normale operazione di rimozione.

DFS_FORCE_REMOVE (0x80000000)

Se questo flag viene specificato per uno spazio dei nomi DFS basato su dominio, la destinazione radice viene rimossa anche se non è accessibile.

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

Il chiamante deve avere privilegi di amministratore nel server DFS.

L'elenco seguente mostra i valori dei parametri da specificare, in base al risultato desiderato.

Requisiti

Vedi anche

Funzioni DFS (Distributed File System)

NetDfsAddRootTarget

Funzioni di gestione di rete

Panoramica della gestione della rete