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

Статья
11/20/2024

Применяет распространенные переводы к заданной строке URL-адреса, создавая новую строку URL-адреса.

Синтаксис

INTSHCUTAPI HRESULT TranslateURLA(
        PCSTR pcszURL,
        DWORD dwInFlags,
  [out] PSTR  *ppszTranslatedURL
);

Параметры

pcszURL

Тип: PCTSTR

Адрес строки URL-адреса, который необходимо преобразовать.

dwInFlags

Тип: DWORD

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

TRANSLATEURL_FL_GUESS_PROTOCOL

Если схема протокола не указана в параметре pcszURL для TranslateURL, система автоматически выбирает схему и добавляет ее в URL-адрес.

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

Если схема протокола не указана в параметре pcszURL, чтобы TranslateURL, система добавляет протокол по умолчанию к URL-адресу.

[out] ppszTranslatedURL

Тип: PTSTR*

Переменная указателя, получающая указатель на только что созданную, переведенную строку URL-адреса, если она есть. Параметр ppszTranslatedURL действителен только в том случае, если функция возвращает S_OK.

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

Тип: HRESULT

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

Возвращаемый код	Описание
E_FLAGS	Сочетание флагов, переданного в dwInFlags, недопустимо.
E_OUTOFMEMORY	Для завершения операции недостаточно памяти.
E_POINTER	Один из входных указателей недопустим.

Замечания

Эта функция не проверяет входную строку URL-адреса. Успешное возвращаемое значение не указывает, что строки URL-адресов являются допустимыми URL-адресами.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	intshcut.h
DLL	Url.dll

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