Funzione NetDfsRemove (lmdfs.h)

Rimuove un collegamento DFS (Distributed File System) o una destinazione di collegamento specifica di un collegamento DFS in uno spazio dei nomi DFS. Quando si rimuove una destinazione di collegamento specifica, il collegamento stesso viene rimosso se l'ultima destinazione del collegamento viene rimossa.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetDfsRemove(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName
);

Parametri

[in] DfsEntryPath

Puntatore a una stringa che specifica il percorso UNC (Universal Naming Convention) del collegamento DFS.

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

\\ Nomecondivisione\DfsName\link_path

dove ShareName è il nome del server di destinazione radice che ospita lo spazio dei nomi DFS autonomo; DfsName è il nome dello spazio dei nomi DFS; e link_path è un collegamento DFS.

Il secondo formato è il seguente:

\\ Domainname\DomDfsname\link_path

dove DomainName è il nome del dominio che ospita lo spazio dei nomi DFS basato su dominio; DomDfsname è il nome dello spazio dei nomi DFS; e link_path è un collegamento DFS.

Questo parametro è obbligatorio.

[in, optional] ServerName

Puntatore a una stringa che specifica il nome del server della destinazione del collegamento. Per ulteriori informazioni, vedere la sezione Osservazioni successiva. Impostare questo parametro su NULL se il collegamento e tutte le destinazioni di collegamento devono essere rimosse.

[in, optional] ShareName

Puntatore a una stringa che specifica il nome della condivisione della destinazione del collegamento. Impostare questo parametro su NULL se il collegamento e tutte le destinazioni di collegamento devono essere rimosse.

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. Per altre informazioni sulla chiamata di funzioni che richiedono privilegi di amministratore, vedere Esecuzione con privilegi speciali.

Quando si chiama NetDfsRemove per rimuovere una destinazione da un collegamento, è necessario specificare lo stesso nome del server di destinazione nel parametro ServerName specificato al momento della creazione del collegamento. Ad esempio, se è stato specificato il nome DNS del server di destinazione quando è stata aggiunta la destinazione al collegamento, è necessario specificare lo stesso nome DNS quando si rimuove il collegamento. Non è possibile specificare il nome NetBIOS.

Esempio

L'esempio di codice seguente illustra come rimuovere una destinazione da un collegamento DFS usando una chiamata alla funzione NetDfsRemove .

#include <windows.h>
#include <lm.h>
#include <lmdfs.h>
#include <stdio.h>
#pragma comment(lib, "Netapi32.lib")

void wmain(int argc, wchar_t *argv[])
{
   DWORD res;
   //
   // All parameters are required.
   //
   if (argc < 4)
      wprintf(L"Syntax: %s DfsEntryPath ServerName ShareName\n", argv[0]);
   else
   {
      //
      // Call the NetDfsRemove function 
      //  to remove the DFS link.
      //
      res = NetDfsRemove(argv[1], argv[2], argv[3]);
      //
      // Display the result of the call.
      //
      if(res == 0)
         printf("Removed DFS link\n");
      else
         printf("Error: %u\n", res);
   }
   return;
}

Requisiti

Vedi anche

Funzioni DFS (Distributed File System)

NetDfsAdd

NetDfsEnum

NetDfsRemoveFtRoot

NetDfsRemoveStdRoot

Funzioni di gestione di rete

Panoramica della gestione della rete