Funzione WNetCancelConnectionA (winnetwk.h)
La funzione WNetCancelConnection annulla una connessione di rete esistente.
La funzione WNetCancelConnection viene fornita per la compatibilità con le versioni a 16 bit di Windows. Altre applicazioni basate su Windows devono chiamare la funzione WNetCancelConnection2 .
Sintassi
DWORD WNetCancelConnectionA(
[in] LPCSTR lpName,
[in] BOOL fForce
);
Parametri
[in] lpName
Puntatore a una stringa con terminazione null costante che specifica il nome del dispositivo locale reindirizzato o della risorsa di rete remota da cui disconnettersi.
Quando 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, vengono annullate solo le connessioni alle reti remote senza dispositivi.
[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 è 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 |
|---|---|
|
Il profilo utente è in formato non corretto. |
|
Il sistema non è in grado di aprire il profilo utente per elaborare connessioni persistenti. |
|
Il dispositivo è in uso da un processo attivo e non può essere disconnesso. |
|
Si è verificato un errore specifico della rete. Per ottenere una descrizione dell'errore, chiamare la funzione WNetGetLastError . |
|
Il nome specificato dal parametro lpName non è un dispositivo reindirizzato oppure il sistema non è attualmente connesso al dispositivo specificato dal parametro . |
|
Esistono file aperti e il parametro fForce è FALSE. |
Commenti
Windows Server 2003 e Windows XP: Le funzioni WNet creano ed eliminano le lettere dell'unità di rete nello spazio dei nomi dei dispositivi MS-DOS associato a una sessione di accesso perché i dispositivi MS-DOS sono identificati da AuthenticationID. Un AuthenticationID è l'identificatore univoco locale o LUID associato a una sessione di accesso. Ciò può influire sulle applicazioni che chiamano una delle funzioni di rete per creare una lettera di unità di rete con un accesso utente, ma eseguire una query sulle lettere di unità di rete esistenti con un accesso utente diverso. Un esempio di questa situazione potrebbe essere quando il secondo accesso di un utente viene creato 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 del dispositivo MS-DOS.
Nota
L'intestazione winnetwk.h definisce WNetCancelConnection come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |