Funzione NetUseDel (lmuse.h)

Articolo
08/24/2023

La funzione NetUseDel termina una connessione a una risorsa condivisa.

È anche possibile usare la funzione WNetCancelConnection2 per terminare una connessione di rete.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

Parametri

[in] UncServerName

Nome UNC del computer in cui eseguire questa funzione. Se si tratta di un parametro NULL, viene usato il computer locale.

Se il parametro UncServerName specificato è un computer remoto, il computer remoto deve supportare chiamate RPC remote usando il meccanismo legacy remote Access Protocol.

Questa stringa è Unicode se vengono definite _WIN32_WINNT o FORCE_UNICODE .

[in] UseName

Puntatore a una stringa che specifica il percorso della connessione da eliminare.

Questa stringa è Unicode se vengono definite _WIN32_WINNT o FORCE_UNICODE .

[in] ForceLevelFlags

Livello di forza da usare per eliminare la connessione.

Questo parametro può essere uno dei valori seguenti definiti nel file di intestazione lmuseflg.h .

Valore	Significato
USE_NOFORCE	Non eseguire la disconnessione se i file aperti esistono nella connessione.
USE_FORCE	Non eseguire la disconnessione se sono presenti file aperti nella connessione.
USE_LOTS_OF_FORCE	Chiudere tutti i file aperti ed eliminare la connessione.

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 funzione NetUseDel si applica solo al client Server Message Block (WORKSTATION DI GESTIONE LAN). La funzione NetUseDel non supporta condivisioni DFS (Distributed File System) o altri file system di rete. Per terminare una connessione a una condivisione usando un provider di rete diverso (WebDAV o una condivisione DFS, ad esempio), usare la funzione WNetCancelConnection2 .

Non è necessaria alcuna appartenenza speciale al gruppo per chiamare la funzione NetUseDel . Questa funzione non può essere eseguita in un server remoto, ad eccezione dei casi di compatibilità a livello inferiore.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmuse.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll