Compartilhar via


Função DavAddConnection (davclnt.h)

Cria uma conexão segura com um servidor WebDAV ou com um arquivo ou diretório remoto em um servidor WebDAV.

Sintaxe

DWORD DavAddConnection(
  [in, out]      HANDLE  *ConnectionHandle,
  [in]           LPCWSTR RemoteName,
  [in, optional] LPCWSTR UserName,
  [in, optional] LPCWSTR Password,
  [in]           PBYTE   ClientCert,
  [in]           DWORD   CertSize
);

Parâmetros

[in, out] ConnectionHandle

Um ponteiro para uma variável que recebe o identificador de conexão.

[in] RemoteName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho para o arquivo ou diretório remoto. Essa cadeia de caracteres deve começar com o prefixo "https://".

[in, optional] UserName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome de usuário a ser usado para a conexão. Esse parâmetro é opcional e pode ser NULL.

[in, optional] Password

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém a senha a ser usada para a conexão. Esse parâmetro é opcional e pode ser NULL.

[in] ClientCert

Um ponteiro para um buffer que contém o certificado do cliente a ser usado para a conexão. O certificado deve estar em um formulário serializado.

[in] CertSize

Tamanho, em bytes, do certificado do cliente.

Valor retornado

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.

Comentários

Para fechar a conexão, use a função DavDeleteConnection .

Use essa função quando estiver se conectando a um servidor WebDAV usando o protocolo SSL e, portanto, deve especificar um certificado. Para se conectar a um servidor WebDAV sem especificar um certificado, use uma função de rede do Windows, como WNetAddConnection2 ou WNetAddConnection3.

Requisitos

   
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 Netapi32.lib
DLL Netapi32.dll

Confira também

CertOpenSystemStore