Funzione DavAddConnection (davclnt.h)

Articolo
08/23/2023

Crea una connessione sicura a un server WebDAV o a un file o a una directory remota in un server WebDAV.

Sintassi

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

Parametri

[in, out] ConnectionHandle

Puntatore a una variabile che riceve l'handle di connessione.

[in] RemoteName

Puntatore a una stringa Unicode con terminazione Null che contiene il percorso del file o della directory remota. Questa stringa deve iniziare con il prefisso "https://".

[in, optional] UserName

Puntatore a una stringa Unicode con terminazione Null contenente il nome utente da utilizzare per la connessione. Questo parametro è facoltativo e può essere NULL.

[in, optional] Password

Puntatore a una stringa Unicode con terminazione Null contenente la password da usare per la connessione. Questo parametro è facoltativo e può essere NULL.

[in] ClientCert

Puntatore a un buffer contenente il certificato client da usare per la connessione. Il certificato deve essere in formato serializzato.

[in] CertSize

Dimensioni, in byte, del certificato client.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema.

Commenti

Per chiudere la connessione, usare la funzione DavDeleteConnection .

Usare questa funzione quando ci si connette a un server WebDAV usando il protocollo SSL (Secure Sockets Layer) e pertanto deve specificare un certificato. Per connettersi a un server WebDAV senza specificare un certificato, usare una funzione di rete Windows, ad esempio WNetAddConnection2 o WNetAddConnection3.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	davclnt.h
Libreria	Netapi32.lib
DLL	Netapi32.dll

Vedi anche

CertOpenSystemStore

Condividi tramite