Функция URLAssociationDialogA (intshcut.h)

Статья
02/27/2024

Вызывает диалоговое окно протокола незарегистрированного URL-адреса. Это диалоговое окно позволяет пользователю выбрать приложение для связи с ранее неизвестным протоколом.

Примечание Windows XP с пакетом обновления 2 (SP2) или более поздней версии: эта функция больше не поддерживается.

Синтаксис

INTSHCUTAPI HRESULT URLAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszURL,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

Параметры

hwndParent

Тип: HWND

Дескриптор родительского окна.

dwInFlags

Тип: DWORD

Битовые флаги, определяющие поведение функции. Это значение может быть сочетанием следующих значений:

URLASSOCDLG_FL_USE_DEFAULT_NAME

Используйте имя файла по умолчанию (т. е. Internet Shortcut).

URLASSOCDLG_FL_REGISTER_ASSOC

Зарегистрируйте выбранное приложение в качестве обработчика для протокола, указанного в pcszURL. Приложение регистрируется только в том случае, если этот флаг установлен и пользователь указывает, что требуется постоянная связь.

pcszFile

Тип: PTCSTR

Адрес константной строки с нулевым завершением, содержащей имя файла для связи с протоколом URL-адресов.

pcszURL

Тип: PTCSTR

Адрес константной строки с нулем, содержащей URL-адрес с неизвестным протоколом.

[out] pszAppBuf

Тип: PTSTR

Адрес буфера, который получает путь к приложению, указанный пользователем.

ucAppBufLen

Тип: UINT

Размер pszAppBuf в символах.

Возвращаемое значение

Тип: HRESULT

Примечание По состоянию на Windows XP с пакетом обновления 2 (SP2) эта функция не поддерживается и возвращает E_NOTIMPL во всех ситуациях.

В поддерживаемых системах возвращает S_OK, если приложение зарегистрировано с помощью протокола URL- адреса, или S_FALSE, если ничего не зарегистрировано. Например, функция возвращает S_FALSE, когда пользователь выбирает однократное выполнение через выбранное приложение.

Заголовок intshcut.h определяет URLAssociationDialog в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	intshcut.h
DLL	Url.dll

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