Enumerasi SHARD (shlobj_core.h)

Artikel
03/08/2023

Menunjukkan interpretasi data yang diteruskan oleh SHAddToRecentDocs dalam parameter pv-nya untuk mengidentifikasi item yang statistik penggunaannya sedang dilacak.

Sintaks

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

Konstanta


`SHARD_PIDL` Parameter pv menunjuk ke PIDL yang mengidentifikasi objek file dokumen. PIDL yang mengidentifikasi objek non-file tidak diterima.
`SHARD_PATHA` Parameter pv menunjuk ke string ANSI yang dihentikan null dengan jalur dan nama file objek.
`SHARD_PATHW` Parameter pv menunjuk ke string Unicode yang dihentikan null dengan jalur dan nama file objek.
`SHARD_APPIDINFO` Windows 7 dan yang lebih baru. Parameter pv menunjuk ke struktur SHARDAPPIDINFO yang memasangkan IShellItem yang mengidentifikasi item dengan AppUserModelID yang mengaitkannya dengan proses atau aplikasi tertentu.
`SHARD_APPIDINFOIDLIST` Windows 7 dan yang lebih baru. Parameter pv menunjuk ke struktur SHARDAPPIDINFOIDLIST yang memasangkan PIDL absolut yang mengidentifikasi item dengan AppUserModelID yang mengaitkannya dengan proses atau aplikasi tertentu.
`SHARD_LINK` Windows 7 dan yang lebih baru. Parameter pv adalah penunjuk antarmuka ke objek IShellLink .
`SHARD_APPIDINFOLINK` Windows 7 dan yang lebih baru. Parameter pv menunjuk ke struktur SHARDAPPIDINFOLINK yang memasangkan IShellLink yang mengidentifikasi item dengan AppUserModelID yang mengaitkannya dengan proses atau aplikasi tertentu.
`SHARD_SHELLITEM` Windows 7 dan yang lebih baru. Parameter pv adalah penunjuk antarmuka ke objek IShellItem .

Keterangan

Sebelum Windows 7, SHARD_PIDL, SHARD_PATHA, dan SHARD_PATHW didefinisikan sebagai konstanta individual, bukan sebagai anggota enumerasi.

Saat memberikan IShellLink melalui SHARD_LINK atau SHARD_APPIDINFOLINK, instans IShellLink harus memberikan hal berikut:

Baik PIDL (IShellLink::SetIDList) atau jalur target (IShellLink::SetPath atau IShellLink::SetRelativePath)
Argumen baris perintah (IShellLink::SetArguments)
Lokasi ikon (IShellLink::SetIconLocation)

Nama tampilan harus diatur melalui properti System.Title (PKEY_Title) item. Properti dapat langsung menyimpan nama tampilan atau bisa menjadi representasi string tidak langsung, seperti "@shell32.dll,-1324", untuk menggunakan string yang disimpan. String tidak langsung memungkinkan nama item ditampilkan dalam bahasa yang dipilih pengguna.

Secara opsional, bidang deskripsi (IShellLink::SetDescription) dapat diatur untuk menyediakan tipsalat kustom untuk item di Daftar Lompat.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional, Windows XP, Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	shlobj_core.h (termasuk Shlobj.h)

Lihat juga

SHAddToRecentDocs

Bagikan melalui