Een netwerkverbinding annuleren

Als u een verbinding met een netwerkresource wilt annuleren, kan een toepassing de functie WNetCancelConnection2 aanroepen, zoals wordt weergegeven in het volgende voorbeeld.

De aanroep van WNetCancelConnection2 geeft aan dat een netwerkverbinding niet langer persistent mag zijn. In het voorbeeld wordt een door de toepassing gedefinieerde fouthandler aangeroepen voor het verwerken van fouten en de functie TextOut- voor afdrukken.

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"); 

De functie WNetCancelConnection wordt ondersteund voor compatibiliteit met eerdere versies van Windows for Workgroups. Gebruik WNetCancelConnection2voor nieuwe toepassingen.

Zie Netwerkfouten ophalenvoor meer informatie over het gebruik van een door de toepassing gedefinieerde fouthandler.