Флаги API
Многие функции WinINet принимают массив флагов в качестве параметра. Ниже приведено краткое описание определенных флагов.
-
INTERNET_COOKIE_EVALUATE_P3P
-
-
0x80
-
Указывает, что заголовок Platform for Privacy Protection (P3P) должен быть связан с файлом cookie.
-
-
INTERNET_COOKIE_THIRD_PARTY
-
-
0x10
-
Указывает, что устанавливается или извлекается сторонний файл cookie.
-
-
INTERNET_FLAG_ASYNC
-
-
0x10000000
-
Выполняет только асинхронные запросы к дескрипторам, производным от дескриптора, возвращенного этой функцией. Только функция InternetOpen использует этот флаг.
-
-
INTERNET_FLAG_CACHE_ASYNC
-
-
0x00000080
-
Позволяет выполнять отложенную запись в кэше.
-
-
INTERNET_FLAG_CACHE_IF_NET_FAIL
-
-
0x00010000
-
Возвращает ресурс из кэша в случае сбоя сетевого запроса ресурса из-за ошибки ERROR_INTERNET_CONNECTION_RESET или ERROR_INTERNET_CANNOT_CONNECT . Этот флаг используется в HttpOpenRequest.
-
-
INTERNET_FLAG_DONT_CACHE
-
-
0x04000000
-
Не добавляет возвращенную сущность в кэш. Это идентично предпочтительному значению , INTERNET_FLAG_NO_CACHE_WRITE.
-
-
INTERNET_FLAG_EXISTING_CONNECT
-
-
0x20000000
-
Пытается использовать существующий объект InternetConnect , если он существует с теми же атрибутами, необходимыми для выполнения запроса. Это полезно только для операций FTP, так как FTP является единственным протоколом, который обычно выполняет несколько операций в течение одного сеанса. WinINet кэширует один дескриптор подключения для каждого дескриптора HINTERNET, созданного InternetOpen. Функции InternetOpenUrl и InternetConnect используют этот флаг для подключений Http и Ftp.
-
-
INTERNET_FLAG_FORMS_SUBMIT
-
-
0x00000040
-
Указывает, что это отправка форм.
-
-
INTERNET_FLAG_FROM_CACHE
-
-
0x01000000
-
Не выполняет сетевые запросы. Все сущности возвращаются из кэша. Если запрошенного элемента нет в кэше, возвращается подходящая ошибка, например ERROR_FILE_NOT_FOUND. Только функция InternetOpen использует этот флаг.
-
-
INTERNET_FLAG_FWD_BACK
-
-
0x00000020
-
Указывает, что функция должна использовать копию ресурса, который в настоящее время находится в кэше Интернета. Дата окончания срока действия и другие сведения о ресурсе не проверяются. Если запрошенный элемент не найден в кэше Интернета, система попытается найти ресурс в сети. Это значение появилось в Microsoft Internet Обозреватель 5 и связано с операциями "Вперед" и "Назад" Обозреватель Интернета.
-
-
INTERNET_FLAG_HYPERLINK
-
-
0x00000400
-
При определении того, следует ли перезагружать элемент из сети, принудительно выполняется перезагрузка, если срок действия истекает и время lastModified не возвращается с сервера. Этот флаг может использоваться ftpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest и InternetOpenUrl.
Windows XP и Windows Server 2003 R2 и более ранние версии: Также используется GopherFindFirstFile и GopherOpenFile.
-
-
INTERNET_FLAG_IGNORE_CERT_CN_INVALID
-
-
0x00001000
-
Отключает проверку сертификатов на основе SSL/PCT, возвращаемых с сервера, по имени узла, указанному в запросе. WinINet использует простой проверка сертификатов, сравнивая имена узлов и простые правила подстановочных знаков. Этот флаг можно использовать в HttpOpenRequest и InternetOpenUrl (для HTTP-запросов).
-
-
INTERNET_FLAG_IGNORE_CERT_DATE_INVALID
-
-
0x00002000
-
Отключает проверку сертификатов на основе SSL/PCT на наличие правильных дат действия. Этот флаг можно использовать в HttpOpenRequest и InternetOpenUrl (для HTTP-запросов).
-
-
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP
-
-
0x00008000
-
Отключает обнаружение этого специального типа перенаправления. При использовании этого флага WinINet прозрачно разрешает перенаправление с HTTPS на URL-адреса HTTP. Этот флаг можно использовать в HttpOpenRequest и InternetOpenUrl (для HTTP-запросов).
-
-
INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS
-
-
0x00004000
-
Отключает обнаружение этого специального типа перенаправления. При использовании этого флага WinINet прозрачно разрешает перенаправление с HTTP на URL-адреса HTTPS. Этот флаг можно использовать в HttpOpenRequest и InternetOpenUrl (для HTTP-запросов).
-
-
INTERNET_FLAG_KEEP_CONNECTION
-
-
0x00400000
-
Использует для подключения семантику поддержания активности, если она доступна. Этот флаг используется HttpOpenRequest и InternetOpenUrl (для HTTP-запросов). Этот флаг является обязательным для microsoft network (MSN), NTLM и других типов проверки подлинности.
-
-
INTERNET_FLAG_MAKE_PERSISTENT
-
-
0x02000000
-
Больше не поддерживается.
-
-
INTERNET_FLAG_MUST_CACHE_REQUEST
-
-
0x00000010
-
Идентично предпочтительному значению , INTERNET_FLAG_NEED_FILE. Вызывает создание временного файла, если файл не может быть кэширован. Этот флаг может использоваться ftpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest и InternetOpenUrl.
Windows XP и Windows Server 2003 R2 и более ранние версии: Также используется GopherFindFirstFile и GopherOpenFile.
-
-
INTERNET_FLAG_NEED_FILE
-
-
0x00000010
-
Вызывает создание временного файла, если файл не может быть кэширован. Этот флаг может использоваться ftpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest и InternetOpenUrl.
Windows XP и Windows Server 2003 R2 и более ранние версии: Также используется GopherFindFirstFile и GopherOpenFile.
-
-
INTERNET_FLAG_NO_AUTH
-
-
0x00040000
-
Не пытается выполнить проверку подлинности автоматически. Этот флаг можно использовать в HttpOpenRequest и InternetOpenUrl (для HTTP-запросов).
-
-
INTERNET_FLAG_NO_AUTO_REDIRECT
-
-
0x00200000
-
Не обрабатывает перенаправление автоматически в HttpSendRequest. Этот флаг также может использоваться InternetOpenUrl для HTTP-запросов.
-
-
INTERNET_FLAG_NO_CACHE_WRITE
-
-
0x04000000
-
Не добавляет возвращенную сущность в кэш. Этот флаг используется в , HttpOpenRequest и InternetOpenUrl.
Windows XP и Windows Server 2003 R2 и более ранние версии: Также используется GopherFindFirstFile и GopherOpenFile.
-
-
INTERNET_FLAG_NO_COOKIES
-
-
0x00080000
-
Не добавляет автоматически заголовки файлов cookie в запросы и не добавляет возвращенные файлы cookie в базу данных cookie. Этот флаг можно использовать в HttpOpenRequest и InternetOpenUrl (для HTTP-запросов).
-
-
INTERNET_FLAG_NO_UI
-
-
0x00000200
-
Отключает диалоговое окно cookie. Этот флаг можно использовать в HttpOpenRequest и InternetOpenUrl (только HTTP-запросы).
-
-
INTERNET_FLAG_OFFLINE
-
-
0x01000000
-
Идентично INTERNET_FLAG_FROM_CACHE. Не выполняет сетевые запросы. Все сущности возвращаются из кэша. Если запрошенный элемент отсутствует в кэше, возвращается соответствующая ошибка, например ERROR_FILE_NOT_FOUND. Только функция InternetOpen использует этот флаг.
-
-
INTERNET_FLAG_PASSIVE
-
-
0x08000000
-
Использует пассивную семантику FTP. Только InternetConnect и InternetOpenUrl используют этот флаг. InternetConnect использует этот флаг для FTP-запросов, а InternetOpenUrl — для ftp-файлов и каталогов.
-
-
INTERNET_FLAG_PRAGMA_NOCACHE
-
-
0x00000100
-
Принудительно разрешает запрос сервером-источником, даже если на прокси-сервере существует кэшированная копия. Этот флаг используется для функции InternetOpenUrl (только для http- и HTTPS-запросов) и функции HttpOpenRequest .
-
-
INTERNET_FLAG_RAW_DATA
-
-
0x40000000
-
Возвращает данные в виде структуры WIN32_FIND_DATA при получении сведений о каталоге FTP. Если этот флаг не указан или вызов выполняется через прокси-сервер CERN, InternetOpenUrl возвращает HTML-версию каталога. Только функция InternetOpenUrl использует этот флаг.
Windows XP и Windows Server 2003 R2 и более ранние версии: Также возвращает структуру GOPHER_FIND_DATA при получении сведений о каталоге Gopher.
-
-
INTERNET_FLAG_READ_PREFETCH
-
-
0x00100000
-
Этот флаг в настоящее время отключен.
-
-
INTERNET_FLAG_RELOAD
-
-
0x80000000
-
Принудительное скачивание запрошенного файла, объекта или списка каталога с исходного сервера, а не из кэша. Этот флаг используется в функциях FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest и InternetOpenUrl .
Windows XP и Windows Server 2003 R2 и более ранние версии: Также используется GopherFindFirstFile и GopherOpenFile.
-
-
INTERNET_FLAG_RESTRICTED_ZONE
-
-
0x00020000
-
Указывает, что заданный файл cookie связан с ненадежным сайтом.
-
-
INTERNET_FLAG_RESYNCHRONIZE
-
-
0x00000800
-
Перезагружает http-ресурсы, если ресурс был изменен с момента последнего скачивания. Все ресурсы FTP перезагружаются. Этот флаг можно использовать в ftpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest и InternetOpenUrl.
Windows XP и Windows Server 2003 R2 и более ранние версии: Также используются gopherFindFirstFile и GopherOpenFile, а также ресурсы Gopher перезагружаются.
-
-
INTERNET_FLAG_SECURE
-
-
0x00800000
-
Использует безопасную семантику транзакций. Это означает использование технологии SSL/PCT и имеет смысл только в HTTP-запросах. Этот флаг используется в HttpOpenRequest и InternetOpenUrl, но он является избыточным, если https:// отображается в URL-адресе. Функция InternetConnect использует этот флаг для HTTP-подключений; все дескрипторы запросов, созданные под этим подключением, наследуют этот флаг.
-
-
INTERNET_FLAG_TRANSFER_ASCII
-
-
0x00000001
-
Передает файл как ASCII (только FTP). Этот флаг может использоваться ftpOpenFile, FtpGetFile и FtpPutFile.
-
-
INTERNET_FLAG_TRANSFER_BINARY
-
-
0x00000002
-
Передает файл как двоичный файл (только FTP). Этот флаг может использоваться ftpOpenFile, FtpGetFile и FtpPutFile.
-
-
INTERNET_NO_CALLBACK
-
-
0x00000000
-
Указывает, что для этого API не следует выполнять обратные вызовы. Используется для параметра dxContext функций, которые разрешают асинхронные операции.
-
-
INTERNET_OPTION_SUPPRESS_SERVER_AUTH
-
-
104
-
Задает объект HTTP-запроса таким образом, чтобы он не выполнял вход на серверы-источники, но выполнял автоматический вход на прокси-серверы HTTP. Этот параметр отличается от INTERNET_FLAG_NO_AUTH флага запроса, который предотвращает проверку подлинности как на прокси-серверах, так и на серверах-источниках. Установка этого режима не позволит использовать все материалы учетных данных (предоставленные ранее имя пользователя или пароль или SSL-сертификат клиента) при взаимодействии с сервером-источником. Однако если запрос должен быть транзитом через прокси-сервер проверки подлинности, WinINet по-прежнему будет выполнять автоматическую проверку подлинности на прокси-сервере HTTP в параметрах зоны интрасети для пользователя. Параметр Зоны интрасети по умолчанию разрешает автоматический вход с использованием учетных данных пользователя по умолчанию. Чтобы обеспечить подавление всех идентифицируемой информации, вызывающий объект должен объединить INTERNET_OPTION_SUPPRESS_SERVER_AUTH с флагом INTERNET_FLAG_NO_COOKIES запроса. Этот параметр можно задать только для объектов запроса до их отправки. Попытка задать этот параметр после отправки запроса вернет ERROR_INTERNET_INCORRECT_HANDLE_STATE. Для этого параметра буфер не требуется. Этот параметр используется InternetSetOption только для дескрипторов, возвращаемых HttpOpenRequest. Версия: требуется Internet Обозреватель 8.0 или более поздней версии.
-
-
WININET_API_FLAG_ASYNC
-
-
0x00000001
-
Принудительно выполняет асинхронные операции.
-
-
WININET_API_FLAG_SYNC
-
-
0x00000004
-
Выполняет синхронные операции.
-
-
WININET_API_FLAG_USE_CONTEXT
-
-
0x00000008
-
Заставляет API использовать значение контекста, даже если оно равно нулю.
-
Примечание
WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
Заголовок |
|