Função WNetCancelConnectionW (winnetwk.h)

Artigo
08/27/2023

A função WNetCancelConnection cancela uma conexão de rede existente.

A função WNetCancelConnection é fornecida para compatibilidade com versões de 16 bits do Windows. Outros aplicativos baseados no Windows devem chamar a função WNetCancelConnection2 .

Sintaxe

DWORD WNetCancelConnectionW(
  [in] LPCWSTR lpName,
  [in] BOOL    fForce
);

Parâmetros

[in] lpName

Ponteiro para uma cadeia de caracteres terminada em nulo constante que especifica o nome do dispositivo local redirecionado ou do recurso de rede remota do qual se desconectar.

Quando esse parâmetro especifica um dispositivo local redirecionado, a função cancela apenas o redirecionamento de dispositivo especificado. Se o parâmetro especificar um recurso de rede remota, somente as conexões com redes remotas sem dispositivos serão canceladas.

[in] fForce

Especifica se a desconexão deve ocorrer ou não se houver arquivos ou trabalhos abertos na conexão. Se esse parâmetro for FALSE, a função falhará se houver arquivos ou trabalhos abertos.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um código de erro do sistema, como um dos valores a seguir.

Código de retorno	Descrição
ERROR_BAD_PROFILE	O perfil do usuário está em um formato incorreto.
ERROR_CANNOT_OPEN_PROFILE	O sistema não consegue abrir o perfil do usuário para processar conexões persistentes.
ERROR_DEVICE_IN_USE	O dispositivo está sendo usado por um processo ativo e não pode ser desconectado.
ERROR_EXTENDED_ERROR	Ocorreu um erro específico da rede. Para obter uma descrição do erro, chame a função WNetGetLastError .
ERROR_NOT_CONNECTED	O nome especificado pelo parâmetro lpName não é um dispositivo redirecionado ou o sistema não está conectado atualmente ao dispositivo especificado pelo parâmetro .
ERROR_OPEN_FILES	Há arquivos abertos e o parâmetro fForce é FALSE.

Comentários

Windows Server 2003 e Windows XP: As funções WNet criam e excluem letras de unidade de rede no namespace do dispositivo MS-DOS associado a uma sessão de logon porque os dispositivos MS-DOS são identificados pela AuthenticationID. (Uma AuthenticationID é o identificador localmente exclusivo, ou LUID, associado a uma sessão de logon.) Isso pode afetar aplicativos que chamam uma das funções WNet para criar uma letra de unidade de rede em um logon de usuário, mas consultam letras de unidade de rede existentes em um logon de usuário diferente. Um exemplo dessa situação pode ser quando o segundo logon de um usuário é criado em uma sessão de logon, por exemplo, chamando a função CreateProcessAsUser e o segundo logon executa um aplicativo que chama a função GetLogicalDrives . GetLogicalDrives não retorna letras de unidade de rede criadas por uma função WNet no primeiro logon. Observe que, no exemplo anterior, a primeira sessão de logon ainda existe e o exemplo pode se aplicar a qualquer sessão de logon, incluindo uma sessão dos Serviços de Terminal. Para obter mais informações, consulte Definindo um nome de dispositivo MS-DOS.

Observação

O cabeçalho winnetwk.h define WNetCancelConnection como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winnetwk.h
Biblioteca	Mpr.lib
DLL	Mpr.dll