Функция InternetConnectW (wininet.h)

Статья
03/04/2024

Открывает сеанс FTP или HTTP для данного сайта.

Синтаксис

HINTERNET InternetConnectW(
  [in] HINTERNET     hInternet,
  [in] LPCWSTR       lpszServerName,
  [in] INTERNET_PORT nServerPort,
  [in] LPCWSTR       lpszUserName,
  [in] LPCWSTR       lpszPassword,
  [in] DWORD         dwService,
  [in] DWORD         dwFlags,
  [in] DWORD_PTR     dwContext
);

Параметры

[in] hInternet

Дескриптор, возвращенный предыдущим вызовом InternetOpen.

[in] lpszServerName

Указатель на строку, завершающуюся нулевым значением, которая указывает имя узла интернет-сервера. Кроме того, строка может содержать IP-номер сайта в формате ASCII с точками в десятичном формате (например, 11.0.1.45).

[in] nServerPort

Порт TCP/IP на сервере. Эти флаги задают только используемый порт. Служба задается значением dwService. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
INTERNET_DEFAULT_FTP_PORT	Использует порт по умолчанию для FTP-серверов (порт 21).
INTERNET_DEFAULT_GOPHER_PORT	Использует порт по умолчанию для серверов Gopher (порт 70). Примечание Только Windows XP и Windows Server 2003 R2 и более ранних версий.
INTERNET_DEFAULT_HTTP_PORT	Использует порт по умолчанию для HTTP-серверов (порт 80).
INTERNET_DEFAULT_HTTPS_PORT	Использует порт по умолчанию для серверов HTTPS (порт 443).
INTERNET_DEFAULT_SOCKS_PORT	Использует порт по умолчанию для серверов брандмауэра SOCKS (порт 1080).
INTERNET_INVALID_PORT_NUMBER	Использует порт по умолчанию для службы, указанной dwService.

[in] lpszUserName

Указатель на строку, завершающуюся нулевым значением, которая указывает имя пользователя для входа. Если этот параметр имеет значение NULL, функция использует соответствующее значение по умолчанию. Для протокола FTP по умолчанию используется значение anonymous.

[in] lpszPassword

Указатель на строку, завершающуюся пустым значением, которая содержит пароль, используемый для входа. Если и lpszPassword , и lpszUsername имеют значение NULL, функция использует "анонимный" пароль по умолчанию. В случае FTP пароль по умолчанию — это имя электронной почты пользователя. Если lpszPassword имеет значение NULL, а lpszUsername не равно NULL, функция использует пустой пароль.

[in] dwService

Тип службы для доступа. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
INTERNET_SERVICE_FTP	Служба FTP.
INTERNET_SERVICE_GOPHER	Служба Gopher. Примечание Только Windows XP и Windows Server 2003 R2 и более ранних версий.
INTERNET_SERVICE_HTTP	Служба HTTP.

[in] dwFlags

Параметры, относящиеся к используемой службе. If
DwService является INTERNET_SERVICE_FTP, INTERNET_FLAG_PASSIVE заставляет приложение использовать пассивную семантику FTP.

[in] dwContext

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

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

Возвращает допустимый дескриптор сеанса в случае успешного подключения или значение NULL в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError. Приложение также может использовать InternetGetLastResponseInfo , чтобы определить причину отказа в доступе к службе.

lpszUsername	lpszPassword	Имя пользователя, отправленное на FTP-сервер	Пароль, отправленный на FTP-сервер
NULL	NULL	"anonymous"	Имя электронной почты пользователя
Строка, отличной от NULL	NULL	lpszUsername	""
NULL	Строка, отличной от NULL	ОШИБКА	ОШИБКА
Строка, отличной от NULL	Строка, отличной от NULL	lpszUsername	lpszPassword

Для ftp-сайтов InternetConnect фактически устанавливает соединение с сервером; Для других случаев фактическое подключение не устанавливается, пока приложение не запросит определенную транзакцию.

Для максимальной эффективности приложения, использующие протоколы HTTP, должны стараться свести к минимуму вызовы InternetConnect и избегать вызова этой функции для каждой транзакции, запрошенной пользователем. Одним из способов этого является сохранение небольшого кэша дескрипторов, возвращаемых из InternetConnect; Когда пользователь отправляет запрос к ранее доступ к серверу, этот дескриптор сеанса по-прежнему доступен.

После завершения работы вызывающего приложения с дескриптором HINTERNET , возвращенным InternetConnect, его необходимо закрыть с помощью функции InternetCloseHandle .

Примечание Если запрос отправляется в асинхронном режиме (параметр dwFlagsinternetOpen указывает INTERNET_FLAG_ASYNC), а параметр dwContext равен нулю (INTERNET_NO_CALLBACK), функция обратного вызова, заданная с параметром InternetSetStatusCallback в дескрипторе подключения, не вызывается, однако вызов по-прежнему будет выполняться в асинхронном режиме.

Примеры использования InternetConnect можно найти в следующих разделах.

Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из библиотеки DllMain или из конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).

Примечание

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

Требования

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

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

Включение функциональных возможностей Интернета

Функции WinINet

Share via