Freigeben über


SHARD-Enumeration (shlobj_core.h)

Gibt die Interpretation der von SHAddToRecentDocs übergebenen Daten im pv-Parameter an, um das Element zu identifizieren, dessen Nutzungsstatistiken nachverfolgt werden.

Syntax

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

Konstanten

 
SHARD_PIDL
Der pv-Parameter verweist auf eine PIDL, die das Dateiobjekt des Dokuments identifiziert. PIDLs, die Nichtdateiobjekte identifizieren, werden nicht akzeptiert.
SHARD_PATHA
Der pv-Parameter zeigt auf eine NULL-beendete ANSI-Zeichenfolge mit dem Pfad und Dateinamen des Objekts.
SHARD_PATHW
Der pv-Parameter verweist auf eine Unicode-Zeichenfolge mit NULL-Beendigung mit dem Pfad und Dateinamen des Objekts.
SHARD_APPIDINFO
Windows 7 und höher. Der pv-Parameter verweist auf eine SHARDAPPIDINFO-Struktur , die ein IShellItem koppelt, das das Element mit einer AppUserModelID identifiziert, die es einem bestimmten Prozess oder einer bestimmten Anwendung ordnet.
SHARD_APPIDINFOIDLIST
Windows 7 und höher. Der pv-Parameter verweist auf eine SHARDAPPIDINFOIDLIST-Struktur , die eine absolute PIDL koppelt, die das Element mit einer AppUserModelID identifiziert, die es einem bestimmten Prozess oder einer bestimmten Anwendung ordnet.
SHARD_LINK
Windows 7 und höher. Der pv-Parameter ist ein Schnittstellenzeiger auf ein IShellLink-Objekt .
SHARD_APPIDINFOLINK
Windows 7 und höher. Der pv-Parameter verweist auf eine SHARDAPPIDINFOLINK-Struktur , die einen IShellLink koppelt, der das Element mit einer AppUserModelID identifiziert, die es einem bestimmten Prozess oder einer bestimmten Anwendung ordnet.
SHARD_SHELLITEM
Windows 7 und höher. Der pv-Parameter ist ein Schnittstellenzeiger auf ein IShellItem-Objekt .

Hinweise

Vor Windows 7 wurden SHARD_PIDL, SHARD_PATHA und SHARD_PATHW als einzelne Konstanten und nicht als Enumerationsmember definiert.

Wenn Sie einen IShellLink über SHARD_LINK oder SHARD_APPIDINFOLINK bereitstellen, muss die IShellLink-instance Folgendes bereitstellen:

Der Anzeigename muss über die Eigenschaft System.Title (PKEY_Title) des Elements festgelegt werden. Die -Eigenschaft kann den Anzeigenamen direkt enthalten oder eine indirekte Zeichenfolgendarstellung wie "@shell32.dll,-1324", um eine gespeicherte Zeichenfolge zu verwenden. Eine indirekte Zeichenfolge ermöglicht die Anzeige des Elementnamens in der ausgewählten Sprache des Benutzers.

Optional kann das Beschreibungsfeld (IShellLink::SetDescription) festgelegt werden, um eine benutzerdefinierte QuickInfo für das Element in der Sprungliste bereitzustellen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP, Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)

Weitere Informationen

SHAddToRecentDocs