DavAddConnection-Funktion (davclnt.h)
Erstellt eine sichere Verbindung mit einem WebDAV-Server oder mit einer Remotedatei oder einem Remoteverzeichnis auf einem WebDAV-Server.
Syntax
DWORD DavAddConnection(
[in, out] HANDLE *ConnectionHandle,
[in] LPCWSTR RemoteName,
[in, optional] LPCWSTR UserName,
[in, optional] LPCWSTR Password,
[in] PBYTE ClientCert,
[in] DWORD CertSize
);
Parameter
[in, out] ConnectionHandle
Ein Zeiger auf eine Variable, die das Verbindungshandle empfängt.
[in] RemoteName
Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Pfad zur Remotedatei oder dem Remoteverzeichnis enthält. Diese Zeichenfolge muss mit dem Präfix "https://" beginnen.
[in, optional] UserName
Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Benutzernamen enthält, der für die Verbindung verwendet werden soll. Dieser Parameter ist optional und kann NULL sein.
[in, optional] Password
Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die das Kennwort enthält, das für die Verbindung verwendet werden soll. Dieser Parameter ist optional und kann NULL sein.
[in] ClientCert
Ein Zeiger auf einen Puffer, der das Clientzertifikat enthält, das für die Verbindung verwendet werden soll. Das Zertifikat muss in serialisierter Form vorliegen.
[in] CertSize
Größe des Clientzertifikats in Byte.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode.
Hinweise
Verwenden Sie die Funktion DavDeleteConnection , um die Verbindung zu schließen.
Verwenden Sie diese Funktion, wenn Sie mithilfe des SSL-Protokolls (Secure Sockets Layer) eine Verbindung mit einem WebDAV-Server herstellen und daher ein Zertifikat angeben müssen. Verwenden Sie eine Windows-Netzwerkfunktion wie WNetAddConnection2 oder WNetAddConnection3, um eine Verbindung mit einem WebDAV-Server herzustellen, ohne ein Zertifikat anzugeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | davclnt.h |
| Bibliothek | Netapi32.lib |
| DLL | Netapi32.dll |