Enumeración SHARD (shlobj_core.h)

  • Artículo

Indica la interpretación de los datos pasados por SHAddToRecentDocs en su parámetro pv para identificar el elemento cuyas estadísticas de uso se están realizando el seguimiento.

Syntax

typedef enum {
  SHARD_PIDL,
  SHARD_PATHA,
  SHARD_PATHW,
  SHARD_APPIDINFO,
  SHARD_APPIDINFOIDLIST,
  SHARD_LINK,
  SHARD_APPIDINFOLINK,
  SHARD_SHELLITEM
} SHARD;

Constantes

 
SHARD_PIDL
El parámetro pv apunta a un PIDL que identifica el objeto de archivo del documento. Los PIDL que identifican objetos que no son de archivo no se aceptan.
SHARD_PATHA
El parámetro pv apunta a una cadena ANSI terminada en null con la ruta de acceso y el nombre de archivo del objeto.
SHARD_PATHW
El parámetro pv apunta a una cadena Unicode terminada en null con la ruta de acceso y el nombre de archivo del objeto.
SHARD_APPIDINFO
Windows 7 y versiones posteriores. El parámetro pv apunta a una estructura SHARDAPPIDINFO que empareja un IShellItem que identifica el elemento con un AppUserModelID que lo asocia a un proceso o aplicación determinado.
SHARD_APPIDINFOIDLIST
Windows 7 y versiones posteriores. El parámetro pv apunta a una estructura SHARDAPPIDINFOIDLIST que empareja un PIDL absoluto que identifica el elemento con un AppUserModelID que lo asocia a un proceso o aplicación determinado.
SHARD_LINK
Windows 7 y versiones posteriores. El parámetro pv es un puntero de interfaz a un objeto IShellLink .
SHARD_APPIDINFOLINK
Windows 7 y versiones posteriores. El parámetro pv apunta a una estructura SHARDAPPIDINFOLINK que empareja un IShellLink que identifica el elemento con un AppUserModelID que lo asocia a un proceso o aplicación determinado.
SHARD_SHELLITEM
Windows 7 y versiones posteriores. El parámetro pv es un puntero de interfaz a un objeto IShellItem .

Comentarios

Antes de Windows 7, SHARD_PIDL, SHARD_PATHA y SHARD_PATHW se definieron como constantes individuales, no como miembros de enumeración.

Al proporcionar un IShellLink a través de SHARD_LINK o SHARD_APPIDINFOLINK, la instancia de IShellLink debe proporcionar lo siguiente:

El nombre para mostrar debe establecerse a través de la propiedad System.Title (PKEY_Title) del elemento. La propiedad puede contener directamente el nombre para mostrar o puede ser una representación de cadena indirecta, como "@shell32.dll,-1324", para usar una cadena almacenada. Una cadena indirecta permite mostrar el nombre del elemento en el idioma seleccionado del usuario.

Opcionalmente, el campo de descripción (IShellLink::SetDescription) se puede establecer para proporcionar una información sobre herramientas personalizada para el elemento de la lista de accesos directos.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional, Windows XP, Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado shlobj_core.h (incluya Shlobj.h)

Consulte también

SHAddToRecentDocs