Enumeración SHARD (shlobj_core.h)

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:

• Un PIDL (IShellLink::SetIDList) o la ruta de acceso de destino (IShellLink::SetPath o IShellLink::SetRelativePath)
• Argumentos de la línea de comandos (IShellLink::SetArguments)
• Ubicación del icono (IShellLink::SetIconLocation)

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