Abbrechen einer Netzwerkverbindung

Um eine Verbindung mit einer Netzwerkressource abzubrechen, kann eine Anwendung die WNetCancelConnection2-Funktion aufrufen, wie im folgenden Beispiel gezeigt.

Der Aufruf von WNetCancelConnection2 gibt an, dass eine Netzwerkverbindung nicht mehr dauerhaft sein soll. Im Beispiel wird ein anwendungsdefinierter Fehlerhandler zum Verarbeiten von Fehlern und die TextOut-Funktion zum Drucken aufgerufen.

DWORD dwResult; 
 
// Call the WNetCancelConnection2 function, specifying
//  that the connection should no longer be a persistent one.
//
dwResult = WNetCancelConnection2("z:", 
    CONNECT_UPDATE_PROFILE, // remove connection from profile 
    FALSE);                 // fail if open files or jobs 
 
// Process errors.
//  The device is not a local redirected device.
//
if (dwResult == ERROR_NOT_CONNECTED) 
{ 
    printf("Drive z: not connected.\n"); 
    return dwResult; 
} 
 
// Call an application-defined error handler.
//
else if(dwResult != NO_ERROR) 
{ 
    printf("WNetCancelConnection2 failed.\n"); 
    return dwResult; 
}
//
// Otherwise, report canceling the connection.
//
printf("Connection closed for z: drive.\n"); 

Die WNetCancelConnection-Funktion wird aus Gründen der Kompatibilität mit früheren Versionen von Windows für Arbeitsgruppen unterstützt. Verwenden Sie für neue Anwendungen WNetCancelConnection2.

Weitere Informationen zur Verwendung eines anwendungsdefinierten Fehlerhandlers finden Sie unter Abrufen von Netzwerkfehlern.