Перечисление SHARD (shlobj_core.h)

  • Статья

Указывает интерпретацию данных, переданных SHAddToRecentDocs в параметре pv для идентификации элемента, статистика использования которого отслеживается.

Синтаксис

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

Константы

 
SHARD_PIDL
Параметр pv указывает на PIDL, идентифицирующий объект файла документа. PiDLs, которые идентифицируют объекты, не являющиеся файлами, не принимаются.
SHARD_PATHA
Параметр pv указывает на строку ANSI, завершаемую null, с путем и именем файла объекта.
SHARD_PATHW
Параметр pv указывает на строку Юникода, завершаемую null, с путем и именем файла объекта.
SHARD_APPIDINFO
Windows 7 и более поздние версии. Параметр pv указывает на структуру SHARDAPPIDINFO , которая связывает IShellItem , идентифицирующий элемент с AppUserModelID, который связывает его с определенным процессом или приложением.
SHARD_APPIDINFOIDLIST
Windows 7 и более поздние версии. Параметр pv указывает на структуру SHARDAPPIDINFOIDLIST , которая связывает абсолютный ИДЕНТИФИКАТОР PIDL, идентифицирующий элемент с AppUserModelID, который связывает его с определенным процессом или приложением.
SHARD_LINK
Windows 7 и более поздние версии. Параметр pv — это указатель интерфейса на объект IShellLink .
SHARD_APPIDINFOLINK
Windows 7 и более поздние версии. Параметр pv указывает на структуру SHARDAPPIDINFOLINK , которая связывает IShellLink , идентифицирующий элемент с AppUserModelID, который связывает его с определенным процессом или приложением.
SHARD_SHELLITEM
Windows 7 и более поздние версии. Параметр pv является указателем интерфейса на объект IShellItem .

Комментарии

До Windows 7 SHARD_PIDL, SHARD_PATHA и SHARD_PATHW определялись как отдельные константы, а не как члены перечисления.

При предоставлении IShellLink через SHARD_LINK или SHARD_APPIDINFOLINK экземпляр IShellLink должен предоставлять следующие данные:

Отображаемое имя должно задаваться с помощью свойства System.Title (PKEY_Title) элемента. Свойство может содержать отображаемое имя напрямую или быть косвенным строковым представлением, например "@shell32.dll,-1324", для использования хранимой строки. Непрямая строка позволяет отображать имя элемента на выбранном пользователем языке.

При необходимости можно задать поле описания (IShellLink::SetDescription), чтобы предоставить настраиваемую подсказку для элемента в списке переходов.

Требования

   
Минимальная версия клиента Windows 2000 Professional, Windows XP, Windows 7 [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть shlobj_core.h (включая Shlobj.h)

См. также раздел

SHAddToRecentDocs