API 旗標

許多 WinINet 函式都接受旗標陣列做為參數。 以下是所定義旗標的簡短描述。

INTERNET_COOKIE_EVALUATE_P3P

0x80

表示隱私權保護平臺 (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 會針對InternetOpen所產生的每個HINTERNET控制碼快取單一連線控制碼。 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 Explorer 5 中引進，並與 Internet Explorer 的 [轉 寄] 和 [ 上一頁 ] 按鈕作業相關聯。

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 重新導向至 HTTP URL。 HttpOpenRequest和InternetOpenUrl (可以使用此旗標來進行 HTTP 要求) 。

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

停用這種特殊重新導向類型的偵測。 使用此旗標時，WinINet 會以透明方式允許從 HTTP 重新導向至 HTTPS URL。 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

強制源伺服器解析要求，即使 Proxy 上有快取的複本也一樣。 只有在 HTTP 和 HTTPS 要求上 (InternetOpenUrl 函式) ，且 HttpOpenRequest 函式會使用此旗標。

INTERNET_FLAG_RAW_DATA

0x40000000

擷取 FTP 目錄資訊時，以 WIN32_FIND_DATA 結構傳回資料。 如果未指定此旗標，或透過 CERN Proxy 進行呼叫， InternetOpenUrl 會傳回目錄的 HTML 版本。 只有 InternetOpenUrl 函式會使用此旗標。

Windows XP 和 Windows Server 2003 R2 和更早版本： 也會在擷取 Gopher 目錄資訊時傳回 GOPHER_FIND_DATA 結構。

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 Proxy 伺服器。 此選項與要求旗標INTERNET_FLAG_NO_AUTH不同，這可防止驗證 Proxy 伺服器和源伺服器。 設定此模式會在與源伺服器通訊時，隱藏先前提供使用者名稱/密碼或用戶端 SSL 憑證) 使用任何認證 (資料。 不過，如果要求必須透過驗證 Proxy 傳輸，WinINet 仍會根據使用者的內部網路區域設定，對 HTTP Proxy 執行自動驗證。 預設的內部網路區域設定是允許使用使用者的預設認證自動登入。 為了確保隱藏所有識別資訊，呼叫端應該將INTERNET_OPTION_SUPPRESS_SERVER_AUTH與INTERNET_FLAG_NO_COOKIES要求旗標結合。 只有在傳送要求物件之前，才能設定此選項。 傳送要求之後，嘗試設定此選項將會傳回ERROR_INTERNET_INCORRECT_HANDLE_STATE。 這個選項不需要緩衝區。 InternetSetOption 只會使用 HttpOpenRequest 所傳回的控制碼。 版本：需要 Internet Explorer 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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Wininet.h