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

Статья
11/20/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

Используйте имя файла по умолчанию (то есть "Ярлык в Интернете").

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 [только классические приложения]
целевая платформа	Виндоус
заголовка	intshcut.h
DLL	Url.dll

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