Compartir a través de

Función DavGetHTTPFromUNCPath (davclnt.h)

  • Artículo

Convierte la ruta de acceso UNC especificada en una ruta de acceso HTTP equivalente.

Sintaxis

DWORD DavGetHTTPFromUNCPath(
  [in]      LPCWSTR UncPath,
  [out]     LPWSTR  Url,
  [in, out] LPDWORD lpSize
);

Parámetros

[in] UncPath

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso UNC. Esta ruta de acceso debe tener el formato siguiente:

\\server[@SSL][@port][\path]

, donde

  • server es el nombre del servidor.
  • @SSL es opcional e indica una solicitud para una conexión SSL.
  • port es un número de puerto opcional. Los puertos estándar son 80 para http y 443 para https (SSL).
  • path es opcional y especifica una ruta de acceso a un archivo o directorio remoto en el servidor.

[out] Url

Puntero a un búfer asignado por el autor de la llamada que recibe la ruta de acceso HTTP como una cadena Unicode terminada en null.

[in, out] lpSize

Puntero a una variable que en la entrada especifica el tamaño máximo, en caracteres Unicode, del búfer al que apunta el parámetro HttpPath . Si la función se ejecuta correctamente, en la salida, la variable recibe el número de caracteres que se copiaron en el búfer. Si se produce un error en la función con ERROR_INSUFFICIENT_BUFFER, en la salida, la variable recibe el número de caracteres necesarios para almacenar la ruta de acceso HTTP, incluido el prefijo "http://" o "https://" y el carácter NULL de terminación.

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, como el siguiente valor.

Código devuelto Descripción
ERROR_INSUFFICIENT_BUFFER
 El búfer al que apunta el parámetro HttpPath no era lo suficientemente grande como para almacenar la ruta de acceso HTTP.

Requisitos

Requisito Value
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