Compartilhar via


Função DavCancelConnectionsToServer (davclnt.h)

Fecha todas as conexões com um servidor WebDAV ou um arquivo ou diretório remoto em um servidor WebDAV.

Sintaxe

DWORD DavCancelConnectionsToServer(
  [in] LPWSTR lpName,
       BOOL   fForce
);

Parâmetros

[in] lpName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do arquivo ou servidor remoto. Essa cadeia de caracteres deve estar em um dos seguintes formatos:

  • http://caminhodo servidor/
  • \\server\path
  • server
em que server é o nome de um servidor WebDAV e path é o caminho para um arquivo ou diretório remoto no servidor.

fForce

Um valor booliano que especifica se a conexão deve ser fechada se houver arquivos abertos. Defina esse parâmetro como FALSE se a conexão deve ser fechada somente se não houver arquivos abertos. Defina esse parâmetro como TRUE se a conexão deve ser fechada mesmo se houver arquivos abertos.

Retornar valor

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

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

Código de retorno Descrição
ERROR_INVALID_PARAMETER
O parâmetro lpName continha um valor que não era válido.
WN_BAD_NETNAME
O parâmetro lpName continha um valor que não era um nome de arquivo remoto válido.
WN_NOT_CONNECTED
Nenhuma conexão com o arquivo ou servidor remoto foi encontrada.
WN_OPEN_FILES
Há arquivos abertos na conexão e o parâmetro fForce foi definido como FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho davclnt.h
Biblioteca Davclnt.lib
DLL Davclnt.dll