Share via

Функция DavAddConnection (davclnt.h)

  • Статья

Создает безопасное подключение к серверу WebDAV или удаленному файлу или каталогу на сервере WebDAV.

Синтаксис

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

Параметры

[in, out] ConnectionHandle

Указатель на переменную, которая получает дескриптор соединения.

[in] RemoteName

Указатель на строку Юникода, завершающуюся null, которая содержит путь к удаленному файлу или каталогу. Эта строка должна начинаться с префикса "https://".

[in, optional] UserName

Указатель на строку Юникода, завершающуюся null, которая содержит имя пользователя, используемое для соединения. Этот параметр является необязательным и может иметь значение NULL.

[in, optional] Password

Указатель на строку Юникода, завершающуюся значением NULL, которая содержит пароль, используемый для подключения. Этот параметр является необязательным и может иметь значение NULL.

[in] ClientCert

Указатель на буфер, содержащий сертификат клиента, используемый для подключения. Сертификат должен быть в сериализованной форме.

[in] CertSize

Размер сертификата клиента в байтах.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки.

Комментарии

Чтобы закрыть подключение, используйте функцию DavDeleteConnection .

Используйте эту функцию при подключении к серверу WebDAV по протоколу SSL, поэтому необходимо указать сертификат. Чтобы подключиться к серверу WebDAV без указания сертификата, используйте сетевую функцию Windows, например WNetAddConnection2 или WNetAddConnection3.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header davclnt.h
Библиотека Netapi32.lib
DLL Netapi32.dll

См. также раздел

CertOpenSystemStore