Compartir a través de


Función DavGetUNCFromHTTPPath (davclnt.h)

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

Sintaxis

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

Parámetros

[in] Url

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso HTTP. Esta cadena puede tener cualquiera de los siguientes formatos, donde el servidor es el nombre del servidor y la ruta de acceso es la ruta de acceso a un archivo o directorio remoto en el servidor:

  • ruta de acceso de http:// server/
  • http:// server
  • \\http:// server/path
  • \\http:// server
  • ruta de acceso https:// server/
  • https:// server
  • \\https:// server/path
  • \\https:// server
  • \\server\path
  • \\server

[out] UncPath

Puntero a un búfer asignado por el autor de la llamada que recibe la ruta de acceso UNC 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 UncPath . Si la función se realiza correctamente, en la salida, la variable recibe el número de caracteres que se copiaron en el búfer, incluido el carácter NULL de terminación. 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 UNC, incluido 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 valor siguiente.

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

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