Cancelación de una conexión de red

Para cancelar una conexión a un recurso de red, una aplicación puede llamar a la función WNetCancelConnection2 , como se muestra en el ejemplo siguiente.

La llamada a WNetCancelConnection2 especifica que una conexión de red ya no debe ser persistente. El ejemplo llama a un controlador de errores definido por la aplicación para procesar errores y la función TextOut para imprimir.

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

La función WNetCancelConnection es compatible con versiones anteriores de Windows for Workgroups. Para las nuevas aplicaciones, use WNetCancelConnection2.

Para obtener más información sobre el uso de un controlador de errores definido por la aplicación, consulte Recuperación de errores de red.