Enumerazione SHARD (shlobj_core.h)

Articolo
08/26/2023

Indica l'interpretazione dei dati passati da SHAddToRecentDocs nel relativo parametro pv per identificare l'elemento di cui vengono rilevate le statistiche di utilizzo.

Sintassi

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

Costanti


`SHARD_PIDL` Il parametro pv punta a un FILE PIDL che identifica l'oggetto file del documento. I PIDL che identificano oggetti non file non sono accettati.
`SHARD_PATHA` Il parametro pv punta a una stringa ANSI con terminazione Null con il percorso e il nome file dell'oggetto.
`SHARD_PATHW` Il parametro pv punta a una stringa Unicode con terminazione Null con il percorso e il nome file dell'oggetto.
`SHARD_APPIDINFO` Windows 7 e versioni successive. Il parametro pv punta a una struttura SHARDAPPIDINFO che associa un oggetto IShellItem che identifica l'elemento a un AppUserModelID che lo associa a un processo o a un'applicazione specifica.
`SHARD_APPIDINFOIDLIST` Windows 7 e versioni successive. Il parametro pv punta a una struttura SHARDAPPIDINFOIDLIST che associa un PIDL assoluto che identifica l'elemento con un AppUserModelID che lo associa a un processo o a un'applicazione specifica.
`SHARD_LINK` Windows 7 e versioni successive. Il parametro pv è un puntatore di interfaccia a un oggetto IShellLink .
`SHARD_APPIDINFOLINK` Windows 7 e versioni successive. Il parametro pv punta a una struttura SHARDAPPIDINFOLINK che associa un IShellLink che identifica l'elemento a un AppUserModelID che lo associa a un processo o a un'applicazione specifica.
`SHARD_SHELLITEM` Windows 7 e versioni successive. Il parametro pv è un puntatore di interfaccia a un oggetto IShellItem .

Commenti

Prima di Windows 7, SHARD_PIDL, SHARD_PATHA e SHARD_PATHW sono state definite come costanti singole, non come membri di enumerazione.

Quando si specifica un IShellLink tramite SHARD_LINK o SHARD_APPIDINFOLINK, l'istanza di IShellLink deve fornire quanto segue:

PIDL (IShellLink::SetIDList) o il percorso di destinazione (IShellLink::SetPath o IShellLink::SetRelativePath)
Argomenti della riga di comando (IShellLink::SetArguments)
Percorso icona (IShellLink::SetIconLocation)

Il nome visualizzato deve essere impostato tramite la proprietà System.Title (PKEY_Title) dell'elemento. La proprietà può contenere direttamente il nome visualizzato oppure può essere una rappresentazione di stringa indiretta, ad esempio "@shell32.dll,-1324", per usare una stringa archiviata. Una stringa indiretta consente di visualizzare il nome dell'elemento nella lingua selezionata dell'utente.

Facoltativamente, il campo di descrizione (IShellLink::SetDescription) può essere impostato per fornire una descrizione comando personalizzata per l'elemento nella Jump List.

Requisiti


Client minimo supportato	Windows 2000 Professional, Windows XP, Windows 7 [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	shlobj_core.h (includere Shlobj.h)

Vedi anche

SHAddToRecentDocs

Condividi tramite