Énumération SHARD (shlobj_core.h)

Article
08/26/2023

Indique l’interprétation des données transmises par SHAddToRecentDocs dans son paramètre pv pour identifier l’élément dont les statistiques d’utilisation sont suivies.

Syntax

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

Constantes


`SHARD_PIDL` Le paramètre pv pointe vers un PIDL qui identifie l’objet file du document. Les fichiers PIDL qui identifient des objets non-fichier ne sont pas acceptés.
`SHARD_PATHA` Le paramètre pv pointe vers une chaîne ANSI terminée par une valeur Null avec le chemin d’accès et le nom de fichier de l’objet.
`SHARD_PATHW` Le paramètre pv pointe vers une chaîne Unicode terminée par null avec le chemin d’accès et le nom de fichier de l’objet.
`SHARD_APPIDINFO` Windows 7 et versions ultérieures. Le paramètre pv pointe vers une structure SHARDAPPIDINFO qui associe un IShellItem qui identifie l’élément à un AppUserModelID qui l’associe à un processus ou à une application particulière.
`SHARD_APPIDINFOIDLIST` Windows 7 et versions ultérieures. Le paramètre pv pointe vers une structure SHARDAPPIDINFOIDLIST qui associe un PIDL absolu qui identifie l’élément avec un AppUserModelID qui l’associe à un processus ou une application particulier.
`SHARD_LINK` Windows 7 et versions ultérieures. Le paramètre pv est un pointeur d’interface vers un objet IShellLink .
`SHARD_APPIDINFOLINK` Windows 7 et versions ultérieures. Le paramètre pv pointe vers une structure SHARDAPPIDINFOLINK qui associe un IShellLink qui identifie l’élément à un AppUserModelID qui l’associe à un processus ou à une application particulière.
`SHARD_SHELLITEM` Windows 7 et versions ultérieures. Le paramètre pv est un pointeur d’interface vers un objet IShellItem .

Remarques

Avant Windows 7, SHARD_PIDL, SHARD_PATHA et SHARD_PATHW étaient définis en tant que constantes individuelles, et non en tant que membres d’énumération.

Lorsque vous fournissez un IShellLink via SHARD_LINK ou SHARD_APPIDINFOLINK, le instance IShellLink doit fournir les éléments suivants :

PiDL (IShellLink::SetIDList) ou le chemin cible (IShellLink::SetPath ou IShellLink::SetRelativePath)
Arguments de ligne de commande (IShellLink::SetArguments)
Emplacement de l’icône (IShellLink::SetIconLocation)

Le nom d’affichage doit être défini via la propriété System.Title (PKEY_Title) de l’élément. La propriété peut contenir directement le nom complet ou il peut s’agir d’une représentation sous forme de chaîne indirecte, telle que « @shell32.dll,-1324 », pour utiliser une chaîne stockée. Une chaîne indirecte permet d’afficher le nom de l’élément dans la langue sélectionnée de l’utilisateur.

Si vous le souhaitez, le champ de description (IShellLink::SetDescription) peut être défini pour fournir une info-bulle personnalisée pour l’élément dans la liste de raccourcis.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel, Windows XP, Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	shlobj_core.h (inclure Shlobj.h)

Voir aussi

SHAddToRecentDocs

Partager via