Freigeben über

Abbrechen einer Netzwerkverbindung

  • Artikel

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 persistent sein soll. Im Beispiel wird ein anwendungsdefinierter Fehlerhandler aufgerufen, um Fehler zu verarbeiten, und die TextOut--Funktion zum Drucken.

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 for Workgroups unterstützt. Verwenden Sie für neue Anwendungen WNetCancelConnection2.

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