오류 메시지(Winhttp.h)

아래 나열된 오류 값은 WinHTTP(Microsoft Windows HTTP 서비스) 함수 중 하나가 실패할 때 GetLastError에서 반환되며 WinHttpRequest 개체에서 반환되는 HRESULT 오류의 하위 16비트에서도 반환됩니다.

이름이 "ERROR_WINHTTP_"로 시작하는 오류 값은 WinHTTP 함수와 관련이 있습니다. WinHTTP 함수는 적절한 경우 Windows 오류 메시지도 반환합니다.

ERROR_WINHTTP_AUTO_PROXY_SERVICE_ERROR

12178

지정된 URL에 대한 프록시를 배치할 수 없는 경우 WinHttpGetProxyForUrl 에서 반환됩니다.

ERROR_WINHTTP_AUTODETECTION_FAILED

12180

WinHTTP가 PAC(프록시 자동 구성) 파일의 URL을 검색할 수 없는 경우 WinHttpDetectAutoProxyConfigUrl 에서 반환됩니다.

ERROR_WINHTTP_BAD_AUTO_PROXY_SCRIPT

12166

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_PRIVATE_KEY

애플리케이션에는 클라이언트 인증서와 연결된 프라이빗 키에 액세스하는 데 필요한 권한이 없습니다.

WINDOWS Server 2003 SP1 및 Windows XP SP2: 이 오류는 지원되지 않습니다.

ERROR_WINHTTP_CLIENT_CERT_NO_PRIVATE_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 프로토콜이 발견되었습니다. 예를 들어 WinHTTP 버전 5.1은 클라이언트가 특별히 사용하도록 설정하지 않는 한 SSL2를 지원하지 않습니다.

ERROR_WINHTTP_HEADER_ALREADY_EXISTS

12155

되지 않는; 더 이상 사용되지 않습니다.

ERROR_WINHTTP_HEADER_COUNT_EXCEEDED

12181

WinHTTP가 수신할 수 있는 것보다 많은 수의 헤더가 응답에 있는 경우 WinHttpReceiveResponse 에서 반환됩니다.

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

체계가 변경되었거나 리디렉션을 시도한 모든 시도가 실패했기 때문에 리디렉션에 실패했습니다(기본값은 5회 시도).

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(Secure Sockets Layer) 인증서에서 하나 이상의 오류가 발견되었습니다. 발생한 오류 유형을 확인하려면 상태 콜백 함수에서 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, Windows 2000 Server SP3 [데스크톱 앱만 해당]
재배포 가능 파일	Windows XP 및 Windows 2000에서 WinHTTP 5.0 및 인터넷 Explorer 5.01 이상.
헤더	Winhttp.h

추가 정보

WinHTTP 버전