Función PathCreateFromUrlA (shlwapi.h)

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

Sintaxis

LWSTDAPI PathCreateFromUrlA(
  [in]      PCSTR pszUrl,
  [out]     PSTR  pszPath,
  [in, out] DWORD *pcchPath,
            DWORD dwFlags
);

Parámetros

[in] pszUrl

Tipo: PCTSTR

Cadena terminada en null de longitud máxima INTERNET_MAX_URL_LENGTH que contiene la dirección URL.

[out] pszPath

Tipo: PTSTR de

Puntero a un búfer que, cuando esta función vuelve correctamente, recibe la ruta de acceso MS-DOS. Debe establecer el tamaño de este búfer en MAX_PATH para asegurarse de que es lo suficientemente grande como para contener la cadena devuelta.

[in, out] pcchPath

Tipo: DWORD* de

Número de caracteres del búfer de pszPath.

dwFlags

Tipo: DWORD de

Reservado. Establezca este parámetro en null.

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Observaciones

Nota

El encabezado shlwapi.h define PathCreateFromUrl 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)