Compartir a través de

Función SHParseDisplayName (shlobj_core.h)

  • Artículo

Convierte el nombre para mostrar de un objeto de espacio de nombres shell en una lista de identificadores de elemento y devuelve los atributos del objeto. Esta función es el método preferido para convertir una cadena en un puntero a una lista de identificadores de elemento (PIDL).

Sintaxis

SHSTDAPI SHParseDisplayName(
  [in]            PCWSTR           pszName,
  [in, optional]  IBindCtx         *pbc,
  [out]           PIDLIST_ABSOLUTE *ppidl,
  [in]            SFGAOF           sfgaoIn,
  [out, optional] SFGAOF           *psfgaoOut
);

Parámetros

[in] pszName

Tipo: LPCWSTR

Puntero a una cadena ancha terminada en cero que contiene el nombre para mostrar que se va a analizar.

[in, optional] pbc

Tipo: IBindCtx*

Contexto de enlace que controla la operación de análisis. Este parámetro se establece normalmente en NULL.

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

Dirección de un puntero a una variable de tipo ITEMIDLIST que recibe la lista de identificadores de elemento para el objeto. Si se produce un error, este parámetro se establece en NULL.

[in] sfgaoIn

Tipo: SFGAOF

Valor de ULONG que especifica los atributos que se van a consultar. Para consultar uno o varios atributos, inicialice este parámetro con las marcas que representan los atributos de interés. Para obtener una lista de las marcas de SFGAO disponibles, consulte SFGAO.

[out, optional] psfgaoOut

Tipo: SFGAOF*

Puntero a un ULONG. A cambio, se establecen los atributos que son true para el objeto y que se solicitaron en sfgaoIn . Las marcas de atributo de un objeto pueden ser cero o una combinación de marcas SFGAO. Para obtener una lista de las marcas de SFGAO disponibles, consulte SFGAO.

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.

Comentarios

Debe llamar a esta función desde un subproceso en segundo plano. Si no lo hace, la interfaz de usuario dejará de responder.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 6.0 o posterior)

Consulte también

IBindCtx

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

ITEMIDLIST

SHGetPathFromIDList