Função NetUseDel (lmuse.h)

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 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

Confira também

NetUseAdd

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede

Usar funções

WNetCancelConnection2