Função NetUseDel (lmuse.h)

Artigo
08/24/2023

A função NetUseDel encerra uma conexão com um recurso compartilhado.

Você também pode usar a função WNetCancelConnection2 para encerrar uma conexão de rede.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetUseDel(
  [in] LMSTR UncServerName,
  [in] LMSTR UseName,
  [in] DWORD ForceLevelFlags
);

Parâmetros

[in] UncServerName

O nome UNC do computador no qual executar essa função. Se esse parâmetro for NULL, o computador local será usado.

Se o parâmetro UncServerName especificado for um computador remoto, o computador remoto deverá dar suporte a chamadas RPC remotas usando o mecanismo herdado do Protocolo de Acesso Remoto.

Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.

[in] UseName

Um ponteiro para uma cadeia de caracteres que especifica o caminho da conexão a ser excluída.

Essa cadeia de caracteres será Unicode se _WIN32_WINNT ou FORCE_UNICODE estiverem definidos.

[in] ForceLevelFlags

O nível de força a ser usado na exclusão da conexão.

Esse parâmetro pode ser um dos seguintes valores definidos no arquivo de cabeçalho lmuseflg.h .

Valor	Significado
USE_NOFORCE	Falha na desconexão se houver arquivos abertos na conexão.
USE_FORCE	Não falhe na desconexão se houver arquivos abertos na conexão.
USE_LOTS_OF_FORCE	Feche todos os arquivos abertos e exclua a conexão.

Valor retornado

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

Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista de códigos de erro, consulte Códigos de erro do sistema.

Comentários

A função NetUseDel aplica-se somente ao cliente bloco de mensagens do servidor (estação de trabalho do lan manager). A função NetUseDel não dá suporte a compartilhamentos DFS (Sistema de Arquivos Distribuído) nem a outros sistemas de arquivos de rede. Para encerrar uma conexão com um compartilhamento usando um provedor de rede diferente (WebDAV ou um compartilhamento DFS, por exemplo), use a função WNetCancelConnection2 .

Nenhuma associação de grupo especial é necessária para chamar a função NetUseDel . Essa função não pode ser executada em um servidor remoto, exceto em casos de compatibilidade de nível inferior.

Requisitos


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	lmuse.h (inclua Lm.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll