Поделиться через

Перечисление 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;

Constants

 
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 Профессиональный, Windows XP, Windows 7 [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
Header shlobj_core.h (include Shlobj.h)

См. также

SHAddToRecentDocs

  • Last updated on