IHttpContext 인터페이스
요청 수준 작업에 대한 처리 컨텍스트를 나타내는 개체를 정의합니다.
구문
class IHttpContext
메서드
다음 표에서는 클래스에 의해 노출되는 메서드를 나열합니다 IHttpContext .
| 속성 | Description |
|---|---|
| AllocateRequestMemory | 지정된 양의 메모리를 할당합니다. |
| CancelIo | 보류 중인 송신 또는 수신 작업을 취소합니다. |
| CloneContext | 현재 요청 컨텍스트의 복제본을 만듭니다. |
| DisableNotifications | 현재 모듈에서 이 요청에 대해 보류 중인 특정 알림을 사용하지 않도록 설정합니다. |
| ExecuteRequest | 자식 요청을 실행합니다. |
| GetApplication | 현재 컨텍스트에 대한 애플리케이션 컨테이너를 검색합니다. |
| GetConnection | 현재 컨텍스트에 대한 연결 컨테이너를 검색합니다. |
| GetCurrentExecutionStats | 현재 컨텍스트에 대한 실행 통계를 검색합니다. |
| GetExecuteFlags | 현재 컨텍스트에 대한 실행 플래그를 검색합니다. |
| GetFileInfo | 현재 컨텍스트에 대한 파일 정보 컨테이너를 검색합니다. |
| GetIsLastNotification | 현재 모듈 호스트 내에서 이 요청에 대해 더 많은 알림이 보류 중인지 여부를 나타냅니다. |
| GetMetadata | 현재 요청 컨텍스트에 대한 메타데이터 컨테이너를 검색합니다. |
| GetModuleContextContainer | 현재 컨텍스트에 대한 모듈 컨텍스트 컨테이너를 검색합니다. |
| GetNextNotification | 현재 모듈 호스트에 대한 다음 알림을 검색합니다. |
| GetParentContext | 현재 컨텍스트의 부모 컨텍스트에 대한 포인터를 검색합니다. |
| GetPhysicalPath | 현재 요청에 대한 실제 경로를 검색합니다. |
| GetRequest | 현재 컨텍스트에 대한 HTTP 요청 컨테이너를 반환합니다. |
| Getresponse | 현재 컨텍스트에 대한 HTTP 응답 컨테이너를 반환합니다. |
| GetResponseHeadersSent | HTTP 응답 헤더가 클라이언트로 전송되었는지 여부를 확인합니다. |
| GetRootContext | 현재 컨텍스트의 루트 컨텍스트에 대한 포인터를 검색합니다. |
| GetScriptMap | 현재 컨텍스트에 대한 스크립트 맵 컨테이너를 검색합니다. |
| GetScriptName | 현재 요청에 대한 URL을 검색합니다. |
| GetScriptTranslated | 현재 요청의 실제 경로를 검색합니다. |
| GetServerVarChanges | 현재 컨텍스트에 대한 서버 변수의 변경 내용을 검색합니다. |
| GetServerVariable | 특정 서버 변수를 검색합니다. |
| GetSite | 현재 컨텍스트에 대한 사이트 정보 컨테이너를 검색합니다. |
| GetTraceContext | 현재 컨텍스트에 대한 추적 컨텍스트 컨테이너를 검색합니다. |
| GetUrlInfo | 현재 컨텍스트에 대한 URL 정보 컨테이너를 검색합니다. |
| GetUser | 현재 컨텍스트에 대한 사용자 정보 컨테이너를 검색합니다. |
| IndicateCompletion | 비동기 작업의 완료를 나타내고 IIS가 호출 스레드에서 실행을 다시 시작하도록 요청합니다. |
| MapHandler | 사이트의 제공 URL, HTTP 동사 쌍에 대한 처리기를 매핑합니다. |
| Mappath | 상대 URL의 실제 경로를 반환합니다. |
| NotifyCustomNotification | 사용자 지정 요청 수준 알림을 발생합니다. |
| PostCompletion | 비동기 작업의 완료를 나타내고 IIS에 스레드 풀에 대한 큐 실행을 요청합니다. |
| ReleaseClonedContext | 복제 IHttpContext 된 instance 해제합니다. |
| SetRequestHandled | 현재 요청에 대한 처리기가 완료되었음을 나타냅니다. |
| SetServerVariable | 서버 변수를 지정된 값으로 설정합니다. |
파생 클래스
| 속성 | Description |
|---|---|
| IHttpContext2 | HTTP 요청의 재처리를 나타내며 비동기 작업 중에 원래 사용자에 대한 정보를 검색할 수 있도록 합니다. |
| IHttpContext3 | HTTP 요청의 재처리를 나타내며 비동기 작업에 대한 추가 지원을 사용하도록 설정합니다. |
| IHttpContext4 | HTTP 요청의 재처리를 나타내며 진단 작업에 대한 추가 지원을 사용하도록 설정합니다. |
설명
인터페이스는 IHttpContext 현재 요청 수준 컨텍스트에 대한 정보에 액세스하기 위한 HTTP 모듈에 대한 기본 프로그래밍 인터페이스를 나타냅니다. 이 인터페이스는 HTTP 모듈을 작성할 때 사용할 수 있는 몇 가지 추가 인터페이스를 검색합니다.
예를 들어 및 GetResponse 메서드는 GetRequest 각각 현재 컨텍스트에 대한 IHttpRequest 및 IHttpResponse 인터페이스를 검색합니다. 이러한 인터페이스를 통해 개발자는 요청 본문 및 응답 본문, HTTP 헤더, 서버 동작 등에 액세스하거나 수정할 수 있습니다.
IIS 7을 사용하면 , ReleaseClonedContextExecuteRequest및 메서드를 사용하여 인터페이스를 IHttpContext 통해 자식 컨텍스트를 CloneContext만들고 실행할 수 있습니다. 또한 IIS는 개발자가 GetParentContext 현재 컨텍스트가 루트, 자식 또는 부모 컨텍스트인지에 따라 동작을 변경할 수 있는 HTTP 모듈을 작성하는 데 도움이 되는 및 GetRootContext 메서드를 제공합니다.
IHttpContext 또한 개발자가 알림의 동작을 제어하는 데 도움이 되는 몇 가지 방법을 제공합니다. 예를 들어 메서드를 DisableNotifications 사용하여 알림을 사용하지 않도록 설정하거나 메서드를 GetIsLastNotification 사용하여 나머지 알림이 있는지 여부를 확인할 수 있습니다. 또한 메서드를 GetNextNotification 사용하여 알림을 병합하거나 메서드를 NotifyCustomNotification 사용하여 사용자 지정 알림을 발생할 수 있습니다.
요구 사항
| 형식 | Description |
|---|---|
| 클라이언트 | - Windows Vista의 IIS 7.0 - Windows 7의 IIS 7.5 - Windows 8의 IIS 8.0 - WINDOWS 10 IIS 10.0 |
| 서버 | - Windows Server 2008의 IIS 7.0 - Windows Server 2008 R2의 IIS 7.5 - Windows Server 2012의 IIS 8.0 - Windows Server 2012 R2의 IIS 8.0 - WINDOWS SERVER 2016 IIS 10.0 |
| 제품 | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0 |
| 헤더 | Httpserv.h |