Función SHILCreateFromPath (shlobj_core.h)

[SHILCreateFromPath está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. Las aplicaciones deben usar SHParseDisplayName en su lugar]

Crea un puntero a una lista de identificadores de elemento (PIDL) desde una ruta de acceso.

Sintaxis

SHSTDAPI SHILCreateFromPath(
  [in]                PCWSTR           pszPath,
  [out]               PIDLIST_ABSOLUTE *ppidl,
  [in, out, optional] DWORD            *rgfInOut
);

Parámetros

[in] pszPath

Tipo: PCWSTR

Puntero a una cadena terminada en null de longitud máxima MAX_PATH que contiene la ruta de acceso que se va a convertir.

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

Ruta de acceso de pszPath expresada como PIDL.

[in, out, optional] rgfInOut

Tipo: DWORD*

Puntero a un valor DWORD que, en la entrada, indica los atributos de la carpeta denominada en pszPath que la aplicación que llama desea recuperar junto con el PIDL. Al salir, este valor contiene los atributos solicitados. Para obtener una lista de posibles marcas de atributo para este parámetro, consulte IShellFolder::GetAttributesOf.

Valor devuelto

Tipo: HRESULT

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

Requisitos