Función UrlCreateFromPathA (shlwapi.h)

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

Sintaxis

LWSTDAPI UrlCreateFromPathA(
  [in]      PCSTR pszPath,
  [out]     PSTR  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 de

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

[in, out] pcchUrl

Tipo: DWORD* de

Número de caracteres de pszUrl.

dwFlags

Tipo: DWORD de

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 es un valor de error COM estándar.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 5.0 o posterior)