Метод IResolveShellLink::ResolveShellLink (shobjidl_core.h)
Запрашивает, чтобы объект папки разрешал ссылку оболочки.
Синтаксис
HRESULT ResolveShellLink(
[in] IUnknown *punkLink,
[in] HWND hwnd,
[in] DWORD fFlags
);
Параметры
[in] punkLink
Тип: IUnknown*
Указатель на интерфейс IShellLink объекта. Затем этот интерфейс можно запросить, чтобы определить содержимое ссылки.
[in] hwnd
Тип: HWND
Дескриптор окна, которое оболочка использует в качестве родительского для диалогового окна. В оболочке отображается диалоговое окно, если при разрешении ссылки требуется заставить у пользователя дополнительные сведения.
[in] fFlags
Тип: DWORD
Флаги действий. Этот параметр может быть сочетанием следующих значений.
SLR_INVOKE_MSI
Вызов установщика Windows.
SLR_NOLINKINFO
Отключите отслеживание распределенных ссылок. По умолчанию отслеживание распределенных ссылок отслеживает съемные носители на нескольких устройствах в зависимости от имени тома. Он также использует UNC-путь для отслеживания удаленных файловой системы, буква диска которых изменилась. Установка SLR_NOLINKINFO отключает оба типа отслеживания.
SLR_NO_UI
Не отображайте диалоговое окно, если не удается разрешить ссылку. Если задано SLR_NO_UI , слово fFlags высокого порядка указывает время ожидания в миллисекундах. Функция возвращает значение , если связь не может быть разрешена в течение времени ожидания. Если для слова высокого порядка задано нулевое значение, время ожидания по умолчанию равно 3000 миллисекунд (3 секунды).
SLR_NOUPDATE
Не обновляйте сведения о ссылке.
SLR_NOSEARCH
Не выполняйте эвристические методы поиска.
SLR_NOTRACK
Не используйте распределенное отслеживание ссылок.
SLR_UPDATE
Если объект ссылки изменился, обновите его путь и список идентификаторов. Если SLR_UPDATE задано, не нужно вызывать IPersistFile::IsDirty , чтобы определить, изменился ли объект ссылки.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Этот метод должен попытаться найти целевой объект ссылки оболочки, даже если целевой объект был перемещен или переименован.
Требования
| Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shobjidl_core.h (включая Shobjidl.h) |
| DLL | Shell32.dll (версия 5.0 или более поздняя) |