Funzione WNetCancelConnection2A (winnetwk.h)

Articolo
08/27/2023

La funzione WNetCancelConnection2 annulla una connessione di rete esistente. È anche possibile chiamare la funzione per rimuovere le connessioni di rete memorizzate che non sono attualmente connesse.

La funzione WNetCancelConnection2 sostituisce la funzione WNetCancelConnection .

Sintassi

DWORD WNetCancelConnection2A(
  [in] LPCSTR lpName,
  [in] DWORD  dwFlags,
  [in] BOOL   fForce
);

Parametri

[in] lpName

Puntatore a una stringa costante con terminazione Null che specifica il nome del dispositivo locale reindirizzato o della risorsa di rete remota da cui disconnettersi.

Se questo parametro specifica un dispositivo locale reindirizzato, la funzione annulla solo il reindirizzamento del dispositivo specificato. Se il parametro specifica una risorsa di rete remota, tutte le connessioni senza dispositivi vengono annullate.

[in] dwFlags

Tipo di connessione. Vengono definiti i valori seguenti.

Valore	Significato
0	Il sistema non aggiorna le informazioni sulla connessione. Se la connessione è stata contrassegnata come persistente nel Registro di sistema, il sistema continua a ripristinare la connessione al successivo accesso. Se la connessione non è stata contrassegnata come persistente, la funzione ignora l'impostazione del flag CONNECT_UPDATE_PROFILE.
CONNECT_UPDATE_PROFILE	Il sistema aggiorna il profilo utente con le informazioni che la connessione non è più persistente. Il sistema non ripristinerà questa connessione durante le operazioni di accesso successive. La disconnessione delle risorse tramite nomi remoti non ha alcun effetto sulle connessioni persistenti.

[in] fForce

Specifica se la disconnessione deve verificarsi se sono presenti file o processi aperti nella connessione. Se questo parametro è FALSE, la funzione ha esito negativo se sono presenti file o processi aperti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio uno dei valori seguenti.

Codice restituito	Descrizione
ERROR_BAD_PROFILE	Il profilo utente è in un formato non corretto.
ERROR_CANNOT_OPEN_PROFILE	Il sistema non è in grado di aprire il profilo utente per elaborare le connessioni permanenti.
ERROR_DEVICE_IN_USE	Il dispositivo è in uso da un processo attivo e non può essere disconnesso.
ERROR_EXTENDED_ERROR	Si è verificato un errore specifico della rete. Per ottenere una descrizione dell'errore, chiamare la funzione WNetGetLastError .
ERROR_NOT_CONNECTED	Il nome specificato dal parametro lpName non è un dispositivo reindirizzato o il sistema non è attualmente connesso al dispositivo specificato dal parametro .
ERROR_OPEN_FILES	Sono presenti file aperti e il parametro fForce è FALSE.

Commenti

Windows Server 2003 e Windows XP: Le funzioni WNet creano ed eliminano le lettere di unità di rete nello spazio dei nomi del dispositivo MS-DOS associato a una sessione di accesso perché i dispositivi MS-DOS sono identificati da AuthenticationID. AuthenticationID è l'identificatore univoco locale o LUID associato a una sessione di accesso. Ciò può influire sulle applicazioni che chiamano una delle funzioni WNet per creare una lettera di unità di rete con un accesso utente, ma eseguire una query per le lettere di unità di rete esistenti con un accesso utente diverso. Un esempio di questa situazione può essere quando viene creato il secondo accesso di un utente all'interno di una sessione di accesso, ad esempio chiamando la funzione CreateProcessAsUser e il secondo accesso esegue un'applicazione che chiama la funzione GetLogicalDrives . GetLogicalDrives non restituisce lettere di unità di rete create da una funzione WNet sotto il primo accesso. Si noti che nell'esempio precedente la prima sessione di accesso esiste ancora e l'esempio può essere applicato a qualsiasi sessione di accesso, inclusa una sessione di Servizi Terminal. Per altre informazioni, vedere Definizione di un nome di dispositivo MS-DOS.

Esempio

Per un esempio di codice che illustra come annullare una connessione a una risorsa di rete con una chiamata alla funzione WNetCancelConnection2 , vedere Annullamento di una connessione di rete.

Nota

L'intestazione winnetwk.h definisce WNetCancelConnection2 come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnetwk.h
Libreria	Mpr.lib
DLL	Mpr.dll