Интерфейс IObjectWithAppUserModelID (shobjidl_core.h)
Предоставляет методы, позволяющие реализующим пользовательский объект IAssocHandler предоставлять доступ к явному идентификатору модели пользователя приложения (AppUserModelID). Эти сведения используются для определения того, можно ли добавить определенный тип файла в список переходов приложения.
Наследование
Интерфейс IObjectWithAppUserModelID наследуется от интерфейса IUnknown . IObjectWithAppUserModelID также имеет следующие типы элементов:
Методы
Интерфейс IObjectWithAppUserModelID содержит следующие методы.
|
IObjectWithAppUserModelID::GetAppID Извлекает явный идентификатор пользовательской модели приложения обработчика типа файла (AppUserModelID), если он был объявлен. |
|
IObjectWithAppUserModelID::SetAppID Задает уникальный определяемый приложением идентификатор пользовательской модели приложения (AppUserModelID), определяющий объект в качестве обработчика для определенного типа файла. Этот метод используется приложениями, которым требуются динамические идентификаторы AppUserModelID. |
Комментарии
В списке переходов этого приложения отображаются только типы файлов, для которых приложение является зарегистрированным обработчиком. Когда приложение использует явный идентификатор AppUserModelID для идентификации себя, а также принадлежащих ему окон и процессов, этот идентификатор AppUserModelID также должен быть задан в реализации обработчика, чтобы обработчик распознал как связанный с этим приложением. Когда приложение обращается к файлу, в результате чего вызывается SHAddToRecentDocs , предпринимается попытка добавить файл в категорию Последние или Частые или, возможно, в пользовательскую категорию в списке переходов этого приложения. Если приложение является зарегистрированным обработчиком для этого типа файла, определяемым как таковой идентификатором AppUserModelID обработчика, соответствующим AppUserModelID приложения, этот файл добавляется в список переходов. В противном случае он фильтруется и не отображается.
Когда следует реализовать
Реализация этого интерфейса предоставляется в Windows. Приложения, создающие пользовательские папки оболочки, предоставляющие перечисление обработчика сопоставлений, необходимое системе для определения файлов, разрешенных в списке переходов приложения, должны реализовывать собственные версии.Когда следует использовать
Этот объект необходим, только если приложение использует явные идентификаторы AppUserModelID. Без явного идентификатора AppUserModelID для предоставления этого объекта нет необходимости.IObjectWithAppUserModelID всегда используется как часть более крупного объекта, который использует явные идентификаторы AppUserModelID и хочет предоставить эти сведения системе.
Система вызывает метод IObjectWithAppUserModelID::GetAppID , реализованный в обработчике, чтобы определить, является ли приложение зарегистрированным обработчиком для типа файла.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shobjidl_core.h (включая Shobjidl.h) |
См. также раздел
Идентификаторы модели пользователя приложения (Идентификаторы AppUserModelID)