错误代码门户
MicrosoftWindows WinHTTP错误代码

12044

ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED

其他表示形式：0x00002F0C · 0x2F0C · ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED

这是什么问题？

代码 12044 · Windows WinHTTP 报告的问题。

译文说明

当服务器请求客户端身份验证时，由 WinHttpReceiveResponse 返回。 Windows Server 2003 SP1 和 Windows XP SP2：不支持此错误。 服务器需要 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：不支持此错误。

Google Translate · 此内容为自动翻译。技术术语及适用条件请以英文原文为准。

官方说明 · 原文

Returned by WinHttpReceiveResponse when the server requests client authentication. Windows Server 2003 with SP1 and Windows XP with SP2: This error is not supported. The server requires SSL client Authentication. The application retrieves the list of certificate issuers by calling WinHttpQueryOption with the WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST option. For more information, see the WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST option. If the server requests the client certificate, but does not require it, the application can alternately call WinHttpSetOption with the WINHTTP_OPTION_CLIENT_CERT_CONTEXT option. In this case, the application specifies the WINHTTP_NO_CLIENT_CERT_CONTEXT macro in the *lpBuffer* parameter of WinHttpSetOption. For more information, see the WINHTTP_OPTION_CLIENT_CERT_CONTEXT option. Windows Server 2003 with SP1 and Windows XP with SP2: This error is not supported.

故障排除与诊断链接

请先确认文档中的产品、版本及发生环境与当前情况一致。

来源与使用条款

Error Messages (Winhttp.h) ↗

作者：Microsoft and MicrosoftDocs contributors
许可证：Creative Commons Attribution 4.0 International
核查日期：2026-11-12

修改记录：Extracted numeric codes, symbolic names and English message text; converted Markdown/HTML to plain text and normalized whitespace; added Korean product context, namespace labels, status classification and separately labeled official links. No machine translation of message text. 译文说明已标注为自动翻译。

来源详情 · 许可证原文与声明