Énumération SHARD (shlobj_core.h)

  • Article

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 :

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