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 関数を使用します。
この関数は、Secure Sockets Layer (SSL) プロトコルを使用して WebDAV サーバーに接続する場合に使用するため、証明書を指定する必要があります。 証明書を指定せずに WebDAV サーバーに接続するには、 WNetAddConnection2 や WNetAddConnection3 などの Windows ネットワーク機能を使用します。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | davclnt.h |
Library | Netapi32.lib |
[DLL] | Netapi32.dll |