Метод IResolveShellLink::ResolveShellLink (shobjidl_core.h)

Статья
08/26/2023

Запрашивает, чтобы объект папки разрешал ссылку оболочки.

Синтаксис

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 или более поздняя)

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

IResolveShellLink

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