Función ILCreateFromPathA (shlobj_core.h)

Devuelve la estructura ITEMIDLIST asociada a una ruta de acceso de archivo especificada.

Sintaxis

PIDLIST_ABSOLUTE ILCreateFromPathA(
  [in] PCSTR pszPath
);

Parámetros

[in] pszPath

Tipo: PCTSTR

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso. Esta cadena no debe tener más de MAX_PATH caracteres de longitud, incluido el carácter nulo de terminación.

Valor devuelto

Tipo: PIDLIST_ABSOLUTE

Devuelve un puntero a un ITEMIDLIST estructura que corresponde a la ruta de acceso.

Observaciones

Llame a ILFree para liberar el ITEMIDLIST cuando haya terminado con él.

Nota

El encabezado shlobj_core.h define ILCreateFromPath 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 XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlobj_core.h (incluya Shlobj.h, Shlobj_core.h, Shlobj.h, Shlobj_core.h)
biblioteca de	Shell32.lib
DLL de	Shell32.dll (versión 5.0 o posterior)
conjunto de API de	ext-ms-win-shell-shell32-l1-2-1 (introducido en Windows 10, versión 10.0.10240)