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 结尾的 Unicode 字符串的指针。 此字符串必须以“https://”前缀开头。

[in, optional] UserName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要用于连接的用户名。 此参数是可选的，可以为 NULL。

[in, optional] Password

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要用于连接的密码。 此参数是可选的，可以为 NULL。

[in] ClientCert

指向缓冲区的指针，该缓冲区包含要用于连接的客户端证书。 证书必须采用序列化形式。

[in] CertSize

客户端证书的大小（以字节为单位）。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值为 系统错误代码。

备注

若要关闭连接，请使用 DavDeleteConnection 函数。

使用安全套接字层 (SSL) 协议连接到 WebDAV 服务器时使用此函数，因此必须指定证书。 若要在不指定证书的情况下连接到 WebDAV 服务器，请使用 Windows 网络函数，例如 WNetAddConnection2 或 WNetAddConnection3。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	davclnt.h
Library	Netapi32.lib
DLL	Netapi32.dll

请参阅

CertOpenSystemStore