SHARD-Enumeration (shlobj_core.h)

Artikel
08/26/2023

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:

Entweder eine PIDL (IShellLink::SetIDList) oder der Zielpfad (IShellLink::SetPath oder IShellLink::SetRelativePath)
Befehlszeilenargumente (IShellLink::SetArguments)
Symbolspeicherort (IShellLink::SetIconLocation)

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

Share via