WinHTTP.h (錯誤訊息)

當其中一個 Microsoft Windows HTTP 服務 (WinHTTP) 函式失敗時，GetLastError會傳回下列錯誤值，而且也會在來自 WinHttpRequest物件的較低 16 位HRESULT錯誤傳回時傳回。

名稱開頭為 「ERROR_WINHTTP_」 的錯誤值是 WinHTTP 函式特有的。 WinHTTP 函式也會在適當情況下傳回 Windows 錯誤訊息。

ERROR_WINHTTP_AUTO_PROXY_SERVICE_ERROR

12178

當找不到指定 URL 的 Proxy 時， WinHttpGetProxyForUrl 所傳回。

ERROR_WINHTTP_AUTODETECTION_FAILED

12180

WinHttpDetectAutoProxyConfigUrl 如果 WinHTTP 無法探索 Proxy 自動設定的 URL (PAC) 檔案，則由 WinHttpDetectAutoProxyConfigUrl 傳回。

ERROR_WINHTTP_BAD_AUTO_PROXY_SCRIPT

12166

在 Proxy 自動設定 (PAC) 檔案中執行腳本程式碼時發生錯誤。

ERROR_WINHTTP_CANNOT_CALL_AFTER_OPEN

12103

如果呼叫Open方法之後無法要求指定的選項，則由HttpRequest物件傳回。

ERROR_WINHTTP_CANNOT_CALL_AFTER_SEND

12102

如果呼叫Send方法之後，無法執行要求的作業，則由HttpRequest物件傳回。

ERROR_WINHTTP_CANNOT_CALL_BEFORE_OPEN

12100

如果無法在呼叫Open方法之前執行要求的作業，則由HttpRequest物件傳回。

ERROR_WINHTTP_CANNOT_CALL_BEFORE_SEND

12101

如果無法在呼叫Send方法之前執行要求的作業，則由HttpRequest物件傳回。

ERROR_WINHTTP_CANNOT_CONNECT

12029

如果與伺服器的連線失敗，則傳回 。

ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED

伺服器需要 SSL 用戶端驗證。 應用程式會使用WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST選項呼叫WinHttpQueryOption來擷取憑證簽發者清單。 如需詳細資訊，請參閱 WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST 選項。

如果伺服器要求用戶端憑證，但不需要它，應用程式可以使用WINHTTP_OPTION_CLIENT_CERT_CONTEXT選項替代呼叫WinHttpSetOption。 在此情況下，應用程式會在WinHttpSetOption的lpBuffer參數中指定WINHTTP_NO_CLIENT_CERT_CONTEXT宏。 如需詳細資訊，請參閱 WINHTTP_OPTION_CLIENT_CERT_CONTEXT 選項。

Windows Server 2003 SP1 和 Windows XP SP2： 不支援此錯誤。

ERROR_WINHTTP_CLIENT_CERT_NO_ACCESS_PRI加值稅E_KEY

應用程式沒有存取與用戶端憑證相關聯之私密金鑰的必要許可權。

Windows Server 2003 SP1 和 Windows XP SP2： 不支援此錯誤。

ERROR_WINHTTP_CLIENT_CERT_NO_PRI加值稅E_KEY

SSL 用戶端憑證的內容沒有與其相關聯的私密金鑰。 用戶端憑證可能已匯入到沒有私密金鑰的電腦。

Windows Server 2003 SP1 和 Windows XP SP2： 不支援此錯誤。

ERROR_WINHTTP_CHUNKED_ENCODING_HEADER_SIZE_OVERFLOW

12183

在剖析區塊編碼過程中遇到溢位條件時， WinHttpReceiveResponse 會傳回。

ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED

12044

當伺服器要求用戶端驗證時， 由 WinHttpReceiveResponse 傳回。

Windows Server 2003 SP1 和 Windows XP SP2： 不支援此錯誤。

ERROR_WINHTTP_CONNECTION_ERROR

12030

與伺服器的連線已重設或終止，或遇到不相容的 SSL 通訊協定。 例如，除非用戶端特別啟用 SSL2，否則 WinHTTP 5.1 版不支援 SSL2。

ERROR_WINHTTP_HEADER_ALREADY_EXISTS

12155

過時;不再使用。

ERROR_WINHTTP_HEADER_COUNT_EXCEEDED

12181

WinHttpReceiveResponse傳回的標頭數目比 WinHTTP 收到的回應中還大。

ERROR_WINHTTP_HEADER_NOT_FOUND

12150

要求的標頭無法找到。

ERROR_WINHTTP_HEADER_SIZE_OVERFLOW

12182

當收到的標頭大小超過要求控制碼的限制時， WinHttpReceiveResponse 會傳回。

ERROR_WINHTTP_INCORRECT_HANDLE_STATE

12019

無法執行要求的作業，因為提供的控制碼未處於正確的狀態。

ERROR_WINHTTP_INCORRECT_HANDLE_TYPE

12018

針對此作業提供的控制碼類型不正確。

ERROR_WINHTTP_INTERNAL_ERROR

12004

發生內部錯誤。

ERROR_WINHTTP_INVALID_OPTION

12009

對 WinHttpQueryOption或WinHttpSetOption的要求指定了不正確選項值。

ERROR_WINHTTP_INVALID_QUERY_REQUEST

12154

過時;不再使用。

ERROR_WINHTTP_INVALID_SERVER_RESPONSE

12152

無法剖析伺服器回應。

ERROR_WINHTTP_INVALID_URL

12005

URL 無效。

ERROR_WINHTTP_LOGIN_FAILURE

12015

登入嘗試失敗。 發生此錯誤時，應該使用 WinHttpCloseHandle關閉要求控制碼。 必須先建立新的要求控制碼，再重試原本產生此錯誤的函式。

ERROR_WINHTTP_NAME_NOT_RESOLVED

12007

無法解析伺服器名稱。

ERROR_WINHTTP_NOT_INITIALIZED

12172

過時;不再使用。

ERROR_WINHTTP_OPERATION_CANCELLED

12017

作業已取消，通常是因為作業完成之前，要求已關閉的控制碼。

ERROR_WINHTTP_OPTION_NOT_SETTABLE

12011

無法設定要求的選項，只能查詢。

ERROR_WINHTTP_OUT_OF_HANDLES

12001

過時;不再使用。

ERROR_WINHTTP_REDIRECT_FAILED

12156

重新導向失敗，因為配置已變更或嘗試重新導向失敗， (預設值為五次嘗試) 。

ERROR_WINHTTP_RESEND_REQUEST

12032

WinHTTP 函式失敗。 您可以在相同的要求控制碼上重試所需的函式。

ERROR_WINHTTP_RESPONSE_DRAIN_OVERFLOW

12184

當傳入回應超過內部 WinHTTP 大小限制時傳回。

ERROR_WINHTTP_SCRIPT_EXECUTION_ERROR

12177

執行腳本時發生錯誤。

ERROR_WINHTTP_SECURE_CERT_CN_INVALID

12038

當憑證 CN 名稱與傳遞的值不相符時傳回， (相當於 CERT_E_CN_NO_MATCH 錯誤) 。

ERROR_WINHTTP_SECURE_CERT_DATE_INVALID

12037

表示在根據目前系統時鐘或已簽署檔案中的時間戳記進行驗證時，必要的憑證不在其有效期間內，或者認證鏈結的有效期間未正確巢狀 (相當於CERT_E_EXPIRED 或 CERT_E_VALIDITYPERIODNESTING 錯誤) 。

ERROR_WINHTTP_SECURE_CERT_REV_FAILED

12057

表示無法檢查撤銷，因為撤銷伺服器已離線， (相當於 CRYPT_E_REVOCATION_OFFLINE) 。

ERROR_WINHTTP_SECURE_CERT_REVOKED

12170

表示憑證已撤銷 (相當於 CRYPT_E_REVOKED) 。

ERROR_WINHTTP_SECURE_CERT_WRONG_USAGE

12179

表示憑證對要求的使用量無效， (相當於 CERT_E_WRONG_USAGE) 。

ERROR_WINHTTP_SECURE_CHANNEL_ERROR

12157

表示發生錯誤與安全通道 (相當於 「winerror.h」 標頭檔中所列的 「SEC_E_」 和 「SEC_I_」 的錯誤碼) 。

ERROR_WINHTTP_SECURE_FAILURE

12175

在伺服器所傳送的安全通訊端層 (SSL) 憑證中找到一或多個錯誤。 若要判斷遇到哪種類型的錯誤，請檢查狀態回呼函式中的 WINHTTP_CALLBACK_STATUS_SECURE_FAILURE 通知。 如需詳細資訊，請參閱 WINHTTP_STATUS_CALLBACK。

ERROR_WINHTTP_SECURE_INVALID_CA

12045

表示已處理憑證鏈結，但在信任提供者不信任的根憑證中終止， (相當於 CERT_E_UNTRUSTEDROOT) 。

ERROR_WINHTTP_SECURE_INVALID_CERT

12169

表示憑證無效， (相當於CERT_E_ROLE、CERT_E_PATHLENCONST、CERT_E_CRITICAL、CERT_E_PURPOSE、CERT_E_ISSUERCHAINING、CERT_E_MALFORMED和CERT_E_CHAINING) 等錯誤。

ERROR_WINHTTP_SHUTDOWN

12012

WinHTTP 函式支援正在關閉或卸載。

ERROR_WINHTTP_TIMEOUT

12002

要求已逾時。

不論 Windows HTTP 服務中設定的逾時值為何，都可能會因為 TCP/IP 逾時行為而傳回此錯誤。

ERROR_WINHTTP_UNABLE_TO_DOWNLOAD_SCRIPT

12167

無法下載 PAC 檔案。 例如，PAC URL 所參考的伺服器可能尚未連線，或伺服器傳回 404 NOT FOUND 回應。

ERROR_WINHTTP_UNHANDLED_SCRIPT_TYPE

12176

不支援腳本類型。

ERROR_WINHTTP_UNRECOGNIZED_SCHEME

12006

URL 指定了 「HTTP：」 或 「HTTPs：」 以外的配置。

ERROR_NOT_ENOUGH_MEMORY

記憶體不足，無法完成要求的作業。

頭： 在 Winerror.h 中宣告

ERROR_INSUFFICIENT_BUFFER

提供給函式的緩衝區大小，以位元組為單位，不足以包含傳回的資料。 如需詳細資訊，請參閱特定函式。

頭： 在 Winerror.h 中宣告

ERROR_INVALID_HANDLE

傳遞至應用程式程式設計介面的控制碼 (API) 已失效或關閉。

頭： 在 Winerror.h 中宣告

ERROR_NO_MORE_FILES

找不到其他檔案。

頭： 在 Winerror.h 中宣告

ERROR_NO_MORE_ITEMS

找不到其他專案。

頭： 在 Winerror.h 中宣告

ERROR_NOT_SUPPORTED

未載入必要的通訊協定堆疊，而且應用程式無法啟動 WinSock。

頭： 在 Winerror.h 中宣告

備註

針對 Windows XP 和 Windows 2000，請參閱 WinHttp 起始頁的 執行時間需求 一節。

規格需求

需求	值
最低支援的用戶端	Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003、具有 SP3 的 Windows 2000 Server [僅限傳統型應用程式]
可轉散發套件	Windows XP 和 Windows 2000 上的 WinHTTP 5.0 和 Internet Explorer 5.01 或更新版本。
標頭	WinHTTP.h

另請參閱

WinHTTP 版本