Compartir a través de

Función DavAddConnection (davclnt.h)

  • Artículo

Crea una conexión segura a un servidor WebDAV o a un archivo o directorio remotos en un servidor WebDAV.

Sintaxis

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

Parámetros

[in, out] ConnectionHandle

Puntero a una variable que recibe el identificador de conexión.

[in] RemoteName

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso al archivo o directorio remoto. Esta cadena debe comenzar con el prefijo "https://".

[in, optional] UserName

Puntero a una cadena Unicode terminada en null que contiene el nombre de usuario que se usará para la conexión. Este parámetro es opcional y puede ser NULL.

[in, optional] Password

Puntero a una cadena Unicode terminada en null que contiene la contraseña que se va a usar para la conexión. Este parámetro es opcional y puede ser NULL.

[in] ClientCert

Puntero a un búfer que contiene el certificado de cliente que se va a usar para la conexión. El certificado debe estar en un formato serializado.

[in] CertSize

Tamaño, en bytes, del certificado de cliente.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema.

Comentarios

Para cerrar la conexión, use la función DavDeleteConnection .

Use esta función al conectarse a un servidor WebDAV mediante el protocolo Capa de sockets seguros (SSL) y, por tanto, debe especificar un certificado. Para conectarse a un servidor WebDAV sin especificar un certificado, use una función de red de Windows como WNetAddConnection2 o WNetAddConnection3.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado davclnt.h
Library Netapi32.lib
Archivo DLL Netapi32.dll

Consulte también

CertOpenSystemStore