영어로 읽기

다음을 통해 공유


HTTP Server API(HTTP 서버 API)

HTTP Server API 기술 개요입니다.

HTTP 서버 API를 개발하려면 다음 헤더가 필요합니다.

이 기술에 대한 프로그래밍 지침은 다음을 참조하세요.

열거형

 
HTTP_503_RESPONSE_VERBOSITY

HTTP_503_RESPONSE_VERBOSITY 열거형은 503, 서비스를 사용할 수 없음, 오류 응답에 대한 세부 정보 표시 수준을 정의합니다. 이 구조체는 요청 큐에서 HttpServer503ResponseProperty를 설정하거나 쿼리할 때 사용해야 합니다.
HTTP_AUTH_STATUS

요청의 인증 상태를 정의합니다.
HTTP_AUTHENTICATION_HARDENING_LEVELS

서버 강화 수준.
HTTP_CACHE_POLICY_TYPE

HTTP_CACHE_POLICY_TYPE 열거형 형식은 사용 가능한 캐시 정책을 정의합니다.
HTTP_DATA_CHUNK_TYPE

데이터 청크의 데이터 원본을 정의합니다.
HTTP_DELEGATE_REQUEST_PROPERTY_ID

대리자 요청에 대한 속성 정보를 설명합니다.
HTTP_ENABLED_STATE

요청 큐, 서버 세션 또는 URL 그룹의 상태를 정의합니다.
HTTP_FEATURE_ID

HTTP 기능에 대한 식별자를 지정하는 상수를 정의합니다.
HTTP_HEADER_ID

HTTP_HEADER_ID 열거형 형식은 HTTP 요청 및 응답에 대한 알려진 헤더를 나열하고 배열 인덱스를 각 헤더와 연결합니다.
HTTP_LOG_DATA_TYPE

로그 데이터의 형식을 식별합니다.
HTTP_LOGGING_ROLLOVER_TYPE

로그 파일 롤오버 형식을 정의합니다.
HTTP_LOGGING_TYPE

수행되는 로깅 유형을 정의합니다.
HTTP_QOS_SETTING_TYPE

HTTP_QOS_SETTING_INFO 구조에 포함된 QOS 설정의 유형을 식별합니다.
HTTP_REQUEST_AUTH_TYPE

HTTP_REQUEST_AUTH_TYPE 열거형은 HTTP Server API에서 지원하는 인증 유형을 정의합니다. 이 열거형은 HTTP_REQUEST_AUTH_INFO 구조체에서 사용됩니다.
HTTP_REQUEST_INFO_TYPE

HTTP_REQUEST_INFO_TYPE 열거형은 HTTP_REQUEST_INFO 구조에 포함된 정보의 형식을 정의합니다.
HTTP_REQUEST_PROPERTY

요청에 대해 HTTP 서버 API에 의해 구성된 속성을 정의합니다.
HTTP_REQUEST_TIMING_TYPE

정보가 HTTP_REQUEST_TIMING_INFO 반환될 가능한 요청 타이밍을 지정하는 상수를 정의합니다.
HTTP_RESPONSE_INFO_TYPE

HTTP_RESPONSE_INFO_TYPE 열거형은 HTTP_RESPONSE_INFO 구조에 포함된 정보의 형식을 정의합니다. 이 열거형은 HTTP_RESPONSE_INFO 구조체에서 사용됩니다.
HTTP_SERVER_PROPERTY

URL 그룹, 서버 세션 또는 요청 큐에서 HTTP 서버 API에 의해 구성된 속성을 정의합니다.
HTTP_SERVICE_BINDING_TYPE

HTTP_SERVICE_BINDING_TYPE 열거형 형식은 서비스 이름에 대한 문자열 형식을 지정합니다.
HTTP_SERVICE_CONFIG_CACHE_KEY

HttpSetServiceConfiguration 및 HttpQueryServiceConfiguration 함수에 사용됩니다.
HTTP_SERVICE_CONFIG_ID

서비스 구성 옵션을 정의합니다.
HTTP_SERVICE_CONFIG_QUERY_TYPE

HTTP_SERVICE_CONFIG_QUERY_TYPE 열거형 형식은 만들 쿼리의 다양한 형식을 정의합니다. HTTP_SERVICE_CONFIG_SSL_QUERY, HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 및 HTTP_SERVICE_CONFIG_URLACL_QUERY 구조에 사용됩니다.
HTTP_SERVICE_CONFIG_TIMEOUT_KEY

HTTP_SERVICE_CONFIG_TIMEOUT_KEY 열거형은 HTTP_SERVICE_CONFIG_TIMEOUT_SET 구조를 통해 쿼리되거나 구성된 타이머 유형을 정의합니다.
HTTP_VERB

HTTP_VERB 열거형 형식은 HTTP_REQUEST 구조체에서 알려진 표준 HTTP 동사를 지정하는 데 사용되는 값을 정의합니다. 이러한 알려진 동사의 대부분은 아래 표시된 대로 RFC 2616 및 RFC 2518에 설명되어 있습니다.

Functions

 
HTTP_EQUAL_VERSION

HTTP_VERSION 구조체가 지정된 주/부 버전 조합과 같거나 0이 아니면 0이 아닌 값을 반환합니다.
HTTP_GREATER_EQUAL_VERSION

HTTP_GREATER_EQUAL_VERSION 매크로는 HTTP_VERSION 구조체가 지정된 주/부 버전 조합보다 크거나 같거나 0이 아니면 0이 아닌 값을 반환합니다.
HTTP_GREATER_VERSION

HTTP_VERSION 구조체가 지정된 주/부 버전 조합보다 크거나 그렇지 않으면 0이 아닌 값을 반환합니다.
HTTP_IS_NULL_ID

HTTP_OPAQUE_ID NULL인지 확인합니다.
HTTP_LESS_EQUAL_VERSION

HTTP_VERSION 구조체가 지정된 주/부 버전 조합보다 작거나 같거나 0이 아니면 0이 아닌 값을 반환합니다.
HTTP_LESS_VERSION

HTTP_VERSION 구조체가 지정된 주/부 버전 조합보다 작거나 그렇지 않으면 0이 아닌 값을 반환합니다.
HTTP_NOT_EQUAL_VERSION

HTTP_VERSION 구조체가 지정된 주/부 버전 조합보다 크거나 작거나 같은 경우 0이 아닌 값을 반환합니다.
HTTP_SET_NULL_ID

HTTP_SET_NULL_ID 매크로는 HTTP_OPAQUE_ID NULL로 설정합니다.
HTTP_SET_VERSION

지정된 HTTP_VERSION 구조를 지정된 주/부 버전 조합으로 설정합니다.
HttpAddFragmentToCache

HttpAddFragmentToCache 함수는 검색할 수 있는 지정된 이름의 데이터 조각을 캐시하거나 지정된 이름으로 캐시된 데이터를 업데이트합니다.
HttpAddUrl

지정된 URL과 일치하는 요청이 지정된 HTTP Server API 요청 큐로 라우팅되도록 등록합니다.
HttpAddUrlToUrlGroup

지정된 URL을 URL 그룹 ID로 식별된 URL 그룹에 추가합니다.
HTTPAPI_EQUAL_VERSION

HTTPAPI_VERSION 구조체가 지정된 주/부 버전 조합과 정확히 같거나 그렇지 않으면 0이 아닌 값을 반환합니다.
HTTPAPI_GREATER_VERSION

HTTPAPI_VERSION 구조체가 지정된 주/부 버전 조합보다 크거나 그렇지 않으면 0이 아닌 값을 반환합니다.
HTTPAPI_LESS_VERSION

HTTPAPI_VERSION 구조체가 지정된 주/부 버전 조합보다 작거나 그렇지 않으면 0이 아닌 값을 반환합니다.
HTTPAPI_VERSION_GREATER_OR_EQUAL

HTTPAPI_VERSION_GREATER_OR_EQUAL HTTPAPI_VERSION 구조체가 지정된 주/부 버전 조합보다 크거나 같거나 0이 아니면 0이 아닌 값을 반환합니다.
HttpCancelHttpRequest

HttpCancelHttpRequest 함수는 지정된 reqest를 취소합니다.
HttpCloseRequestQueue

HttpCreateRequestQueue에서 만든 지정된 요청 큐에 대한 핸들을 닫습니다.
HttpCloseServerSession

서버 세션 ID로 식별되는 서버 세션을 삭제합니다.
HttpCloseUrlGroup

URL 그룹 ID로 식별된 URL 그룹을 닫습니다.
HttpCreateHttpHandle

호출하는 애플리케이션에 대한 HTTP 요청 큐를 만들고 핸들을 반환합니다.
HttpCreateRequestQueue

새 요청 큐를 만들거나 기존 요청 큐를 엽니다.
HttpCreateServerSession

지정된 버전에 대한 서버 세션을 만듭니다.
HttpCreateUrlGroup

지정된 서버 세션 아래에 URL 그룹을 만듭니다.
HttpDeclarePush

HTTP 서버 푸시에 사용할 리소스-하위 리소스 관계를 선언합니다. 그런 다음 HTTP.sys 기본 프로토콜, 연결, 클라이언트 및 정책에서 푸시 작업을 허용하는 경우 지정된 리소스에 대해 HTTP 2.0 서버 푸시를 수행합니다.
HttpDelegateRequestEx

원본 요청 큐에서 대상 요청 큐로 요청을 위임합니다.
HttpDeleteServiceConfiguration

HTTP 서버 API 구성 저장소에서 IP 주소 또는 SSL 인증서와 같은 지정된 데이터를 한 번에 하나의 레코드로 삭제합니다.
HttpFindUrlGroupId

URL 및 요청 큐에 대한 URL 그룹 ID를 검색합니다.
HttpFlushResponseCache

지정된 요청 큐와 연결된 HTTP Server API 캐시에서 사이트 부분이 지정된 UrlPrefix와 일치하는 이름을 가진 모든 응답 조각을 제거합니다.
HttpInitialize

HttpInitialize 함수는 HTTP 서버 API 드라이버를 초기화하고, 아직 시작하지 않은 경우 시작하며, 응답 큐 만들기 및 기타 작업을 지원하기 위해 호출 애플리케이션에 대한 데이터 구조를 할당합니다.
HttpIsFeatureSupported

특정 기능이 지원되는지 여부를 확인합니다.
HttpPrepareUrl

다른 HTTP 함수에서 안전하게 사용할 수 있도록 정규화되지 않은 유니코드 또는 punycode URL을 구문 분석하고, 분석하고, 정규화합니다.
HttpQueryRequestQueueProperty

지정된 핸들로 식별된 요청 큐의 속성을 쿼리합니다.
HttpQueryServerSessionProperty

지정된 서버 세션에서 서버 속성을 쿼리합니다.
HttpQueryServiceConfiguration

하나 이상의 HTTP 서버 API 구성 레코드를 검색합니다.
HttpQueryUrlGroupProperty

지정된 URL 그룹의 속성을 쿼리합니다.
HttpReadFragmentFromCache

HttpReadFragmentFromCache 함수는 HTTP Server API 캐시에서 지정된 이름을 가진 응답 조각을 검색합니다.
HttpReceiveClientCertificate

HttpReceiveClientCertificate 함수는 서버 애플리케이션에서 클라이언트 SSL 인증서 또는 CBT(채널 바인딩 토큰)를 검색하는 데 사용됩니다.
HttpReceiveHttpRequest

지정된 요청 큐에서 동기적으로 또는 비동기적으로 사용 가능한 다음 HTTP 요청을 검색합니다.
HttpReceiveRequestEntityBody

지정된 HTTP 요청에 대한 추가 엔터티 본문 데이터를 받습니다.
HttpRemoveUrl

시스템이 지정된 UrlPrefix 문자열과 일치하는 요청을 지정된 요청 큐에 라우팅하는 것을 중지하도록 합니다.
HttpRemoveUrlFromUrlGroup

URL 그룹 ID로 식별된 그룹에서 지정된 URL을 제거합니다.
HttpSendHttpResponse

지정된 HTTP 요청에 HTTP 응답을 보냅니다.
HttpSendResponseEntityBody

HTTP 응답과 연결된 엔터티 본문 데이터를 보냅니다.
HttpSetRequestProperty

새 속성을 설정하거나 지정된 요청에서 기존 속성을 수정합니다.
HttpSetRequestQueueProperty

새 속성을 설정하거나 지정된 핸들로 식별된 요청 큐의 기존 속성을 수정합니다.
HttpSetServerSessionProperty

새 서버 세션 속성을 설정하거나 지정된 서버 세션에서 기존 속성을 수정합니다.
HttpSetServiceConfiguration

HTTP Server API 구성 저장소에 대한 구성 레코드를 만들고 설정합니다.
HttpSetUrlGroupProperty

새 속성을 설정하거나 지정된 URL 그룹의 기존 속성을 수정합니다.
HttpShutdownRequestQueue

지정된 요청 큐 프로세스에 대한 요청 큐 대기를 중지합니다.
HttpTerminate

HTTP Server API에서 애플리케이션의 호출을 처리하는 데 사용하는 리소스를 정리합니다.
HttpUpdateServiceConfiguration

업데이트 HTTP Server API 구성 저장소 내의 구성 레코드에서 TLS(전송 계층 보안) 인증서를 지정하는 서비스 구성 매개 변수입니다.
HttpWaitForDemandStart

새 요청 큐 프로세스에서 처리할 수 있는 새 요청이 도착할 때까지 기다립니다.
HttpWaitForDisconnect

어떤 이유로든 HTTP 클라이언트에 대한 연결이 끊어지면 애플리케이션에 알린다.
HttpWaitForDisconnectEx

이 함수는 HttpWaitForDisconnect에 대한 확장입니다.

구조체

 
HTTP_BANDWIDTH_LIMIT_INFO

HTTP_BANDWIDTH_LIMIT_INFO 구조체는 대역폭 제한 제한을 설정하거나 쿼리하는 데 사용됩니다. 이 구조체는 URL 그룹 또는 서버 세션에서 HttpServerBandwidthProperty를 설정하거나 쿼리할 때 사용해야 합니다.
HTTP_BINDING_INFO

URL 그룹을 요청 큐와 연결하는 데 사용됩니다.
HTTP_BYTE_RANGE

HTTP_BYTE_RANGE 구조체는 캐시된 응답 조각, 파일 또는 기타 데이터 블록 내에서 바이트 범위를 지정하는 데 사용됩니다.
HTTP_CACHE_POLICY

캐시된 응답 조각과 연결된 캐시 정책을 정의하는 데 사용됩니다.
HTTP_CHANNEL_BIND_INFO

HTTP_CHANNEL_BIND_INFO.
HTTP_CONNECTION_LIMIT_INFO

URL 그룹에 대한 최대 미해결 연결 수 제한을 설정하거나 쿼리하는 데 사용됩니다.
HTTP_COOKED_URL

유효성이 검사된 정식 UTF-16 유니코드로 인코딩된 URL 요청 문자열과 포인터 및 요소 길이를 포함합니다.
HTTP_DATA_CHUNK

메모리, 파일 또는 HTTP Server API 응답 조각 캐시의 개별 데이터 블록을 나타냅니다.
HTTP_DELEGATE_REQUEST_PROPERTY_INFO

요청을 위임할 때 추가 속성 정보를 설명합니다.
HTTP_FLOWRATE_INFO

응답의 전송 속도입니다.
HTTP_KNOWN_HEADER

HTTP 요청 또는 HTTP 응답의 알려진 헤더에 대한 헤더 값을 포함합니다.
HTTP_LISTEN_ENDPOINT_INFO

IP 기반 URL이 특정 IP 주소 또는 와일드카드에서 수신 대기해야 하는지 여부를 제어합니다.
HTTP_LOG_DATA

로그 데이터의 형식을 지정하는 값을 포함합니다.
HTTP_LOG_FIELDS_DATA

WC3 로깅을 사용할 때 HTTP 응답에 대해 기록되는 필드를 전달하는 데 사용됩니다.
HTTP_LOGGING_INFO

URL 그룹 또는 서버 세션에서 서버 쪽 로깅을 사용하도록 설정하는 데 사용됩니다.
HTTP_MULTIPLE_KNOWN_HEADERS

둘 이상의 헤더가 필요한 경우 HTTP 응답에 포함된 헤더를 지정합니다.
HTTP_PROPERTY_FLAGS

속성 구성 구조에서 속성 구성을 설정할 때 구성 개체에서 속성을 사용하거나 사용하지 않도록 설정하는 데 사용됩니다.
HTTP_QOS_SETTING_INFO

QOS 설정에 대한 정보를 포함합니다.
HTTP_REQUEST_AUTH_INFO

수신 프로세스가 인증된 클라이언트를 가장하는 데 사용할 수 있는 클라이언트 토큰에 대한 핸들이 있는 요청의 인증 상태 포함합니다.
HTTP_REQUEST_CHANNEL_BIND_STATUS

HTTP_REQUEST_CHANNEL_BIND_STATUS.
HTTP_REQUEST_HEADERS

HTTP 요청과 함께 전송된 헤더를 포함합니다.
HTTP_REQUEST_INFO

요청에 대한 추가 정보를 사용하여 HTTP_REQUEST 구조를 확장합니다.
HTTP_REQUEST_PROPERTY_STREAM_ERROR

HTTP_REQUEST_PROPERTY_STREAM_ERROR 구조체는 HTTP/2 또는 HTTP/3 스트림 오류 코드를 나타냅니다.
HTTP_REQUEST_TIMING_INFO

각 요청 처리 단계에서 소요된 시간에 대한 정보를 포함합니다.
HTTP_REQUEST_V1

HTTP_REQUEST 구조를 사용하여 특정 요청과 연결된 데이터를 반환합니다.
HTTP_REQUEST_V2

요청에 대한 자세한 정보를 사용하여 HTTP_REQUEST_V1 요청 구조를 확장합니다.
HTTP_RESPONSE_HEADERS

HTTP 응답과 함께 전송된 헤더를 포함합니다.
HTTP_RESPONSE_INFO

응답에 대한 추가 정보를 사용하여 HTTP_RESPONSE 구조를 확장합니다.
HTTP_RESPONSE_V1

HTTP 응답과 연결된 데이터를 포함합니다.
HTTP_RESPONSE_V2

응답에 대한 자세한 정보를 사용하여 HTTP 버전 1.0 응답 구조를 확장합니다.
HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS

HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS 구조에는 URL 그룹의 기본 인증에 대한 정보가 포함되어 있습니다. 이 구조체는 HTTP_SERVER_AUTHENTICATION_INFO 구조에 포함되어 있습니다.
HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS

URL 그룹의 다이제스트 인증에 대한 정보를 포함합니다.
HTTP_SERVER_AUTHENTICATION_INFO

URL 그룹 또는 서버 세션에서 서버 쪽 인증을 사용하도록 설정하는 데 사용됩니다.
HTTP_SERVICE_BINDING_A

HTTP_SERVICE_BINDING_A.
HTTP_SERVICE_BINDING_BASE

HTTP_SERVICE_BINDING_BASE.
HTTP_SERVICE_BINDING_W

HTTP_SERVICE_BINDING_W.
HTTP_SERVICE_CONFIG_CACHE_SET

HttpSetServiceConfiguration 함수의 pConfigInformation 매개 변수에 사용됩니다.
HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM

HTTP 서비스가 바인딩하는 IP 주소 목록에서 추가하거나 삭제할 IP 주소를 지정하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY

HttpQueryServiceConfiguration에서 HTTP 서비스가 바인딩하는 IP(인터넷 프로토콜) 주소 목록을 반환하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_SSL_CCS_KEY

포트가 TLS(전송 계층 보안) 핸드셰이크를 수신하는 경우 인증서를 찾기 위해 CCS(중앙 집중식 인증서 저장소) 저장소에 문의해야 Http.sys 지정하는 SSL 인증서 레코드를 식별하는 키 역할을 합니다.
HTTP_SERVICE_CONFIG_SSL_CCS_QUERY

HttpQueryServiceConfiguration 함수를 호출할 때 포트에서 SSL CCS(Centralized Certificate Store) 레코드를 쿼리할 SSL(Secure Sockets Layer) 구성을 지정합니다.
HTTP_SERVICE_CONFIG_SSL_CCS_SET

포트가 TLS(전송 계층 보안) 핸드셰이크를 수신하는 경우 인증서를 찾으려면 CCS(중앙 인증서 저장소) 저장소에 문의해야 Http.sys 지정하는 SSL 인증서 레코드를 나타냅니다.
HTTP_SERVICE_CONFIG_SSL_KEY

지정된 SSL(Secure Sockets Layer) 인증서 레코드가 식별되는 키 역할을 합니다.
HTTP_SERVICE_CONFIG_SSL_PARAM

SSL 구성 저장소에서 레코드를 정의합니다.
HTTP_SERVICE_CONFIG_SSL_QUERY

SSL 구성 저장소에서 쿼리할 특정 레코드를 지정하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_SSL_SET

SSL 저장소에 새 레코드를 추가하거나 기존 레코드를 검색하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_SSL_SNI_KEY

SSL SNI 저장소에서 지정된 SSL(Secure Sockets Layer) SNI(서버 이름 표시) 인증서 레코드가 식별되는 키 역할을 합니다.
HTTP_SERVICE_CONFIG_SSL_SNI_QUERY

SSL SNI 저장소에서 쿼리할 특정 SSL(Secure Sockets Layer) SNI(서버 이름 표시) 인증서 레코드를 지정하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_SSL_SNI_SET

새 SSL(Secure Sockets Layer) SNI(서버 이름 표시) 인증서 레코드를 SSL SNI 저장소에 추가하거나 기존 레코드를 검색하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_TIMEOUT_SET

HTTP Server API 와이드 제한 시간 값을 설정하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_URLACL_KEY

URL 네임스페이스 예약 저장소에서 특정 예약 레코드를 지정하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_URLACL_PARAM

URL 네임스페이스 예약 저장소의 특정 레코드와 연결된 권한을 지정하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_URLACL_QUERY

URL 네임스페이스 예약 저장소에서 쿼리할 특정 예약 레코드를 지정하는 데 사용됩니다.
HTTP_SERVICE_CONFIG_URLACL_SET

URL 예약 저장소에 새 레코드를 추가하거나 기존 레코드를 검색하는 데 사용됩니다.
HTTP_SSL_CLIENT_CERT_INFO

인증서가 유효한지 여부를 확인하는 데 사용할 수 있는 SSL(Secure Sockets Layer) 클라이언트 인증서에 대한 데이터를 포함합니다.
HTTP_SSL_INFO

SSL 핸드셰이크를 통해 얻은 SSL(Secure Sockets Layer)을 사용하는 연결에 대한 데이터를 포함합니다.
HTTP_STATE_INFO

서버 세션 또는 URL 그룹을 사용하거나 사용하지 않도록 설정하는 데 사용됩니다.
HTTP_TIMEOUT_LIMIT_INFO

애플리케이션별 연결 제한 시간 제한을 정의합니다.
HTTP_TRANSPORT_ADDRESS

특정 HTTP 연결에 사용되는 주소(로컬 및 원격)를 지정합니다.
HTTP_UNKNOWN_HEADER

이름이 열거형에 표시되지 않는 HTTP 요청 또는 응답에서 헤더의 이름과 값을 포함합니다.
HTTP_VERSION

요청에 필요하거나 응답이 제공하는 HTTP 프로토콜 버전을 정의합니다.
HTTPAPI_VERSION

HTTP Server API의 버전을 정의합니다.