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 |
| 程式庫 | Netapi32.lib |
| Dll | Netapi32.dll |