winHTTP.h 標頭

Windows HTTP 服務 (WinHTTP) 會使用此標頭。 如需詳細資訊，請參閱

• Windows HTTP 服務 (WinHTTP)

winHTTP.h 包含下列程式設計介面：

函式

WinHttpAddRequestHeaders 將一或多個 HTTP 要求標頭新增至 HTTP 要求控制碼。 (WinHttpAddRequestHeaders)
WinHttpAddRequestHeadersEx 將一或多個 HTTP 要求標頭新增至 HTTP 要求控制碼，讓您能夠使用不同的名稱/值字串。
WinHttpCheckPlatform WinHttpCheckPlatform 函式會判斷此版本的 Microsoft Windows HTTP 服務是否支援目前的平臺， (WinHTTP) 。
WinHttpCloseHandle WinHttpCloseHandle 函式會關閉單一 HINTERNET 控制碼。
WinHttpConnect WinHttpConnect 函式會指定 HTTP 要求的初始目標伺服器，並將 HINTERNET 連線控制碼傳回給該初始目標的 HTTP 會話。
WinHttpCrackUrl WinHttpCrackUrl 函式會將 URL 分成其元件元件，例如主機名稱和路徑。
WinHttpCreateProxyResolver 建立控制碼以供 WinHttpGetProxyForUrlEx 使用。
WinHttpCreateUrl 從元件元件元件建立 URL，例如主機名稱和路徑。
WinHttpDetectAutoProxyConfigUrl 尋找 Proxy 自動設定 (PAC) 檔案的 URL。
WinHttpFreeProxyResult WinHttpFreeProxyResult 函式會釋放從先前呼叫 WinHttpGetProxyResult 擷取的資料。
WinHttpFreeProxySettingsEx 釋放從先前呼叫 WinHttpGetProxySettingsResultEx擷取的資料。
WinHttpFreeQueryConnectionGroupResult 釋放先前呼叫 WinHttpQueryConnectionGroup所配置的記憶體。
WinHttpGetDefaultProxyConfiguration 從登錄擷取預設的 WinHTTP Proxy 組態。
WinHttpGetIEProxyConfigForCurrentUser 擷取目前使用者的 Internet Explorer Proxy 組態。
WinHttpGetProxyForUrl 擷取指定 URL 的 Proxy 資料。 (WinHttpGetProxyForUrl)
WinHttpGetProxyForUrlEx 擷取指定 URL 的 Proxy 資料。 (WinHttpGetProxyForUrlEx)
WinHttpGetProxyResult WinHttpGetProxyResult 函式會擷取對 WinHttpGetProxyForUrlEx 的呼叫結果。
WinHttpGetProxySettingsEx 擷取擴充 Proxy 設定。
WinHttpGetProxySettingsResultEx 擷取 WinHttpGetProxySettingsEx呼叫的結果。
WinHttpOpen 針對應用程式初始化 WinHTTP 函式，並傳回 WinHTTP 會話控制碼。
WinHttpOpenRequest WinHttpOpenRequest 函式會建立 HTTP 要求控制碼。
WinHttpQueryAuthSchemes WinHttpQueryAuthSchemes 函式會傳回伺服器支援的授權配置。
WinHttpQueryConnectionGroup 擷取 HTTP 連線及其 GUID的列舉。
WinHttpQueryDataAvailable 傳回可使用 WinHttpReadData 讀取的資料量，以位元組為單位。
WinHttpQueryHeaders WinHttpQueryHeaders 函式會擷取與 HTTP 要求相關聯的標頭資訊。
WinHttpQueryHeadersEx 擷取與 HTTP 要求相關聯的標頭資訊;提供擷取已剖析標頭名稱和值字串的方法。
WinHttpQueryOption WinHttpQueryOption 函式會在指定的控制碼上查詢網際網路選項。
WinHttpReadData WinHttpReadData 函式會從 WinHttpOpenRequest 函式所開啟的控制碼讀取資料。
WinHttpReadDataEx 從 WinHttpOpenRequest 函式所開啟的控制碼讀取資料。
WinHttpReceiveResponse WinHttpReceiveResponse 函式會等候接收 WinHttpSendRequest 所起始 HTTP 要求的回應。
WinHttpRegisterProxyChangeNotification 註冊 WinHTTP 在有效 Proxy 設定變更時所呼叫的回呼函式。
WinHttpResetAutoProxy 重設自動 Proxy。
WinHttpSendRequest 將指定的要求傳送至 HTTP 伺服器。 (WinHttpSendRequest)
WinHttpSetCredentials WinHttpSetCredentials 函式會將必要的授權認證傳遞至伺服器。
WinHttpSetDefaultProxyConfiguration 在登錄中設定預設的 WinHTTP Proxy 組態。
WinHttpSetOption WinHttpSetOption 函式會設定網際網路選項。
WinHttpSetStatusCallback WinHttpSetStatusCallback 函式會設定 WinHTTP 可在作業期間呼叫為進度的回呼函式。
WinHttpSetTimeouts 設定與 HTTP 交易相關的逾時。
WinHttpTimeFromSystemTime 根據 HTTP 1.0 版規格格式化日期和時間。 (WinHttpTimeFromSystemTime)
WinHttpTimeToSystemTime WinHttpTimeToSystemTime 函式會採用 HTTP 時間/日期字串，並將其轉換成 SYSTEMTIME 結構。
WinHttpUnregisterProxyChangeNotification 取消註冊透過呼叫 WinHttpRegisterProxyChangeNotification註冊的回呼函式。
WinHttpWebSocketClose 關閉 WebSocket 連線。
WinHttpWebSocketCompleteUpgrade 完成 WinHttpSendRequest 所啟動的 WebSocket 交握。
WinHttpWebSocketQueryCloseStatus 擷取伺服器所傳送的關閉狀態。
WinHttpWebSocketReceive 從 WebSocket 連線接收資料。
WinHttpWebSocketSend 透過 WebSocket 連線傳送資料。
WinHttpWebSocketShutdown 將關閉框架傳送至 WebSocket 伺服器以關閉傳送通道，但讓接收通道保持開啟狀態。
WinHttpWriteData WinHttpWriteData 函式會將要求資料寫入 HTTP 伺服器。

回呼函式

WINHTTP_PROXY_CHANGE_CALLBACK 表示應用程式定義的 Proxy 變更回呼函式。
WINHTTP_STATUS_CALLBACK 表示應用程式定義的狀態回呼函式。

結構

HTTP_VERSION_INFO HTTP_VERSION_INFO 結構包含全域 HTTP 版本。
URL_COMPONENTS URL_COMPONENTS 結構包含 URL 的構成部分。 此結構會與 WinHttpC，以及 WinHttpCreateUrl 函式搭配使用。
WINHTTP_ASYNC_RESULT WINHTTP_ASYNC_RESULT 結構包含非同步函式呼叫的結果。 此結構會與WINHTTP_STATUS_CALLBACK原型搭配使用。
WINHTTP_AUTOPROXY_OPTIONS WINHTTP_AUTOPROXY_OPTIONS 結構可用來向 WinHttpGetProxyForURL 函式指出是否要指定 Proxy 自動設定的 URL (PAC) 檔案，或是使用 DHCP 或 DNS 查詢自動找出網路的 URL。
WINHTTP_CERTIFICATE_INFO WINHTTP_CERTIFICATE_INFO 結構包含從伺服器傳回的憑證資訊。 WinHttpQueryOption 函式會使用此結構。
WINHTTP_CONNECTION_GROUP 表示連接群組。
WINHTTP_CONNECTION_INFO WINHTTP_CONNECTION_INFO 結構包含產生回應之要求的來源和目的地 IP 位址。
WINHTTP_CREDS 包含用於伺服器和 Proxy 驗證的使用者認證資訊。 (WINHTTP_CREDS)
WINHTTP_CREDS_EX 包含用於伺服器和 Proxy 驗證的使用者認證資訊。 (WINHTTP_CREDS_EX)
WINHTTP_CURRENT_USER_IE_PROXY_CONFIG WINHTTP_CURRENT_USER_IE_PROXY_CONFIG結構包含 Internet Explorer Proxy 組態資訊。
WINHTTP_EXTENDED_HEADER 將 HTTP 要求標頭表示為名稱/值字串組。
WINHTTP_HEADER_NAME 表示 HTTP 要求標頭名稱。
WINHTTP_HOST_CONNECTION_GROUP 表示連接群組的集合。
WINHTTP_MATCH_CONNECTION_GUID 表示連線的 GUID，用於連線比對。
WINHTTP_PROXY_INFO WINHTTP_PROXY_INFO結構包含會話或預設 Proxy 組態。
WINHTTP_PROXY_RESULT WINHTTP_PROXY_RESULT 結構包含 WinHttpGetProxyResult 所提供的 Proxy 結果專案集合。
WINHTTP_PROXY_RESULT_ENTRY WINHTTP_PROXY_RESULT_ENTRY 結構包含來自 WinHttpGetProxyResult 呼叫的結果專案。
WINHTTP_PROXY_SETTINGS_EX WINHTTP_PROXY_SETTINGS_EX結構代表擴充 Proxy 設定。
WINHTTP_PROXY_SETTINGS_PARAM WINHTTP_PROXY_SETTINGS_PARAM結構代表擴充 Proxy 設定。
WINHTTP_QUERY_CONNECTION_GROUP_RESULT 表示主機連接群組的集合。
WINHTTP_REQUEST_STATS WINHTTP_REQUEST_STATS 結構包含要求的各種統計資料。
WINHTTP_REQUEST_TIMES WINHTTP_REQUEST_TIMES結構包含 HTTP 要求的各種計時資訊。
WINHTTP_SECURITY_INFO WINHTTP_SECURITY_INFO 結構包含 HTTP 要求的各種計時資訊。
WINHTTP_WEB_SOCKET_ASYNC_RESULT WINHTTP_WEB_SOCKET_ASYNC_RESULT包含 WebSocket 作業的結果狀態。
WINHTTP_WEB_SOCKET_STATUS WINHTTP_WEB_SOCKET_STATUS列舉包括 WebSocket 作業的狀態。

列舉

WINHTTP_PROXY_SETTINGS_TYPE 定義常數，指定擴充 Proxy 設定 API 的 Proxy 設定類型。
WINHTTP_REQUEST_STAT_ENTRY WINHTTP_REQUEST_STAT_ENTRY列舉會列出可用的要求統計資料類型。
WINHTTP_REQUEST_TIME_ENTRY WINHTTP_REQUEST_TIME_ENTRY列舉會列出可用的要求計時資訊類型。
WINHTTP_WEB_SOCKET_BUFFER_TYPE WINHTTP_WEB_SOCKET_BUFFER_TYPE列舉包含 WebSocket 緩衝區的類型。
WINHTTP_WEB_SOCKET_CLOSE_STATUS WINHTTP_WEB_SOCKET_CLOSE_STATUS列舉包括 WebSocket 關閉作業的狀態。
WINHTTP_WEB_SOCKET_OPERATION WINHTTP_WEB_SOCKET_OPERATION列舉包括 WebSocket 作業類型。