winhttp.h 헤더

이 헤더는 Windows HTTP 서비스(WinHTTP)에서 사용됩니다. 자세한 내용은 다음을 참조하세요.

• Windows HTTP 서비스(WinHTTP)

winhttp.h에는 다음과 같은 프로그래밍 인터페이스가 포함되어 있습니다.

Functions

WinHttpAddRequestHeaders HTTP 요청 핸들에 하나 이상의 HTTP 요청 헤더를 추가합니다. (WinHttpAddRequestHeaders)
WinHttpAddRequestHeadersEx HTTP 요청 핸들에 하나 이상의 HTTP 요청 헤더를 추가하여 별도의 이름/값 문자열을 사용할 수 있습니다.
WinHttpCheckPlatform WinHttpCheckPlatform 함수는 현재 플랫폼이 이 버전의 WinHTTP(Microsoft Windows HTTP 서비스)에서 지원되는지 여부를 결정합니다.
WinHttpCloseHandle WinHttpCloseHandle 함수는 단일 HINTERNET 핸들을 닫습니다.
WinHttpConnect WinHttpConnect 함수는 HTTP 요청의 초기 대상 서버를 지정하고 초기 대상에 대한 HTTP 세션에 HINTERNET 연결 핸들을 반환합니다.
WinHttpCrackUrl WinHttpCrackUrl 함수는 URL을 호스트 이름 및 경로와 같은 구성 요소 부분으로 구분합니다.
WinHttpCreateProxyResolver WinHttpGetProxyForUrlEx에서 사용할 핸들을 만듭니다.
WinHttpCreateUrl 호스트 이름 및 경로와 같은 구성 요소 부분에서 URL을 만듭니다.
WinHttpDetectAutoProxyConfigUrl PAC(프록시 자동 구성) 파일의 URL을 찾습니다.
WinHttpFreeProxyResult WinHttpFreeProxyResult 함수는 WinHttpGetProxyResult에 대한 이전 호출에서 검색된 데이터를 해제합니다.
WinHttpFreeProxySettingsEx WinHttpGetProxySettingsResultEx에 대한 이전 호출에서 검색된 데이터를 해제합니다.
WinHttpFreeQueryConnectionGroupResult WinHttpQueryConnectionGroup에 대한 이전 호출에 의해 할당된 메모리를 해제합니다.
WinHttpGetDefaultProxyConfiguration 레지스트리에서 기본 WinHTTP 프록시 구성을 검색합니다.
WinHttpGetIEProxyConfigForCurrentUser 현재 사용자의 인터넷 Explorer 프록시 구성을 검색합니다.
WinHttpGetProxyForUrl 지정된 URL에 대한 프록시 데이터를 검색합니다. (WinHttpGetProxyForUrl)
WinHttpGetProxyForUrlEx 지정된 URL에 대한 프록시 데이터를 검색합니다. (WinHttpGetProxyForUrlEx)
WinHttpGetProxyResult WinHttpGetProxyResult 함수는 WinHttpGetProxyForUrlEx 호출 결과를 검색합니다.
WinHttpGetProxySettingsEx 확장 프록시 설정을 검색합니다.
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에서 호출하는 콜백 함수를 등록합니다.
WinHttpResetAutoProxy 자동 프록시를 다시 설정합니다.
WinHttpSendRequest 지정된 요청을 HTTP 서버로 보냅니다. (WinHttpSendRequest)
WinHttpSetCredentials WinHttpSetCredentials 함수는 필요한 권한 부여 자격 증명을 서버에 전달합니다.
WinHttpSetDefaultProxyConfiguration 레지스트리에서 기본 WinHTTP 프록시 구성을 설정합니다.
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 애플리케이션 정의 프록시 변경 콜백 함수를 나타냅니다.
WINHTTP_STATUS_CALLBACK 애플리케이션 정의 상태 콜백 함수를 나타냅니다.

구조체

HTTP_VERSION_INFO HTTP_VERSION_INFO 구조에는 전역 HTTP 버전이 포함됩니다.
URL_COMPONENTS URL_COMPONENTS 구조체에는 URL의 구성 요소가 포함됩니다. 이 구조체는 WinHttpCrackUrl 및 WinHttpCreateUrl 함수와 함께 사용됩니다.
WINHTTP_ASYNC_RESULT WINHTTP_ASYNC_RESULT 구조체에는 비동기 함수 호출의 결과가 포함됩니다. 이 구조체는 WINHTTP_STATUS_CALLBACK 프로토타입과 함께 사용됩니다.
WINHTTP_AUTOPROXY_OPTIONS WINHTTP_AUTOPROXY_OPTIONS 구조체는 WinHttpGetProxyForURL 함수에 PAC(프록시 자동 구성) 파일의 URL을 지정할지 또는 DHCP 또는 DNS 쿼리를 사용하여 네트워크에 대한 URL을 자동으로 찾을지 여부를 나타내는 데 사용됩니다.
WINHTTP_CERTIFICATE_INFO WINHTTP_CERTIFICATE_INFO 구조에는 서버에서 반환된 인증서 정보가 포함됩니다. 이 구조체는 WinHttpQueryOption 함수에서 사용됩니다.
WINHTTP_CONNECTION_GROUP 연결 그룹을 나타냅니다.
WINHTTP_CONNECTION_INFO WINHTTP_CONNECTION_INFO 구조에는 응답을 생성한 요청의 원본 및 대상 IP 주소가 포함됩니다.
WINHTTP_CREDS 서버 및 프록시 인증에 사용되는 사용자 자격 증명 정보를 포함합니다. (WINHTTP_CREDS)
WINHTTP_CREDS_EX 서버 및 프록시 인증에 사용되는 사용자 자격 증명 정보를 포함합니다. (WINHTTP_CREDS_EX)
WINHTTP_CURRENT_USER_IE_PROXY_CONFIG WINHTTP_CURRENT_USER_IE_PROXY_CONFIG 구조에는 인터넷 Explorer 프록시 구성 정보가 포함됩니다.
WINHTTP_EXTENDED_HEADER HTTP 요청 헤더를 이름/값 문자열 쌍으로 나타냅니다.
WINHTTP_HEADER_NAME HTTP 요청 헤더 이름을 나타냅니다.
WINHTTP_HOST_CONNECTION_GROUP 연결 그룹의 컬렉션을 나타냅니다.
WINHTTP_MATCH_CONNECTION_GUID 연결 일치를 위해 연결의 GUID를 나타냅니다.
WINHTTP_PROXY_INFO WINHTTP_PROXY_INFO 구조에는 세션 또는 기본 프록시 구성이 포함됩니다.
WINHTTP_PROXY_RESULT WINHTTP_PROXY_RESULT 구조에는 WinHttpGetProxyResult에서 제공하는 프록시 결과 항목의 컬렉션이 포함됩니다.
WINHTTP_PROXY_RESULT_ENTRY WINHTTP_PROXY_RESULT_ENTRY 구조체에는 WinHttpGetProxyResult 호출의 결과 항목이 포함됩니다.
WINHTTP_PROXY_SETTINGS_EX WINHTTP_PROXY_SETTINGS_EX 구조는 확장 프록시 설정을 나타냅니다.
WINHTTP_PROXY_SETTINGS_PARAM WINHTTP_PROXY_SETTINGS_PARAM 구조는 확장 프록시 설정을 나타냅니다.
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 확장 프록시 설정 API에 대한 프록시 설정 유형을 지정하는 상수를 정의합니다.
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 작업 유형이 포함됩니다.