Cancelando uma conexão de rede

  • Artigo

Para cancelar uma conexão com um recurso de rede, um aplicativo pode chamar a função WNetCancelConnection2 , conforme mostrado no exemplo a seguir.

A chamada para WNetCancelConnection2 especifica que uma conexão de rede não deve mais ser persistente. O exemplo chama um manipulador de erros definido pelo aplicativo para processar erros e a função TextOut para impressão.

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

A função WNetCancelConnection tem suporte para compatibilidade com versões anteriores do Windows para Grupos de Trabalho. Para novos aplicativos, use WNetCancelConnection2.

Para obter mais informações sobre como usar um manipulador de erros definido pelo aplicativo, consulte Recuperando erros de rede.