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

Статья
08/24/2023

Применяет распространенные переводы к заданной строке 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	Один из входных указателей недопустим.

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

Требования

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

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