Compartir a través de

Función UrlCreateFromPathW (shlwapi.h)

  • Artículo

Convierte una ruta de acceso de Microsoft MS-DOS en una dirección URL canónica.

Sintaxis

LWSTDAPI UrlCreateFromPathW(
  [in]      PCWSTR pszPath,
  [out]     PWSTR  pszUrl,
  [in, out] DWORD  *pcchUrl,
            DWORD  dwFlags
);

Parámetros

[in] pszPath

Tipo: PCTSTR

Cadena terminada en null de longitud máxima INTERNET_MAX_URL_LENGTH que contiene la ruta de acceso ms-DOS.

[out] pszUrl

Tipo: PTSTR

Puntero a un búfer que, cuando esta función vuelve correctamente, recibe la dirección URL.

[in, out] pcchUrl

Tipo: DWORD*

Número de caracteres en pszUrl.

dwFlags

Tipo: DWORD

Reservado. Establezca este parámetro en NULL.

Valor devuelto

Tipo: HRESULT

Devuelve S_FALSE si pszPath ya está en formato de dirección URL. En este caso, pszPath simplemente se copiará en pszUrl. De lo contrario, devuelve S_OK si se ejecuta correctamente o si no se establece un valor de error COM estándar.

Comentarios

NotaUrlCreateFromPath no admite rutas de acceso extendidas. Estas son rutas de acceso que incluyen el prefijo de ruta de acceso de longitud extendida "\\?\".
 

Nota

El encabezado shlwapi.h define UrlCreateFromPath como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 5.0 o posterior)