Перечисление 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 должен предоставлять следующие данные:

• PiDL (IShellLink::SetIDList) или целевой путь (IShellLink::SetPath или IShellLink::SetRelativePath)
• Аргументы командной строки (IShellLink::SetArguments)
• Расположение значка (IShellLink::SetIconLocation)

Отображаемое имя должно задаваться с помощью свойства 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