헤더 값을 캐시 정책에 추가합니다.
구문
virtual HRESULT AppendVaryByHeader(
PCSTR pszHeader
) = 0;
매개 변수
pszHeader
추가할 사용자 지정 헤더를 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
또는
NULL
반환 값
HRESULT입니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 값 | 설명 |
|---|---|
| S_OK | 가 NULL임을 pszHeader 나타냅니다.또는 가 pszHeader 변수 헤더 목록에 추가됨을 나타냅니다. |
| ERROR_NOT_ENOUGH_MEMORY | 힙 메모리가 소진되었음을 나타냅니다. |
| E_FAIL | 작업이 실패했음을 나타냅니다. |
설명
요청 또는 응답 이벤트에 등록하는 CHttpModule 파생 클래스는 해당 virtual 메서드의 매개 변수로 IHttpContext 포인터를 받습니다. 사용자 지정 헤더를 추가하려면 IHttpContext::GetResponse 메서드, IHttpResponse::GetCachePolicy 메서드 및 마지막으로 메서드를 AppendVaryByHeader 호출합니다.
AppendVaryByHeader 동작은 구현에 따라 달라집니다. 다음 정보를 지침으로 사용해야 하지만 모든 시나리오에서 올바르지 않을 수 있습니다.
IHttpCachePolicy 인터페이스의 현재 기본 구현자는 변수 헤더 데이터가 포함된 버퍼를 선언합니다private. 구현자를 생성하는 동안 이 버퍼는 비어 있는 것으로 초기화됩니다. 호출 AppendVaryByHeader 할 때마다 AppendVaryByHeader 매개 변수가 NULL이면 pszHeader 즉시 S_OK 반환합니다. 그렇지 않으면 버퍼가 확장되어 null 종료 문자를 포함하여 의 pszHeader복사본을 저장하고 버퍼가 현재 비어 있지 않은 경우 1을 포함합니다. 그런 다음 버퍼가 비어 있지 않으면 ',' 문자가 버퍼에 추가됩니다. 마지막으로 null 종료 문자를 포함한 의 pszHeader내용이 버퍼에 추가됩니다.
구현자에 대한 참고 사항
IHttpCachePolicy 구현자는 에 대한 호출 후에 연결된 데이터가 유효하지 않도록 보장되지 않으므로 매개 변수를 버퍼에 pszHeader 복사 pszHeader 해야 합니다AppendVaryByHeader.
호출자 참고 사항
IHttpCachePolicy 클라이언트는 NULL 매개 변수 또는 null pszHeader 로 종료된 문자열을 메서드에 전달해야 합니다 AppendVaryByHeader . 구현자가 내부 버퍼에 복사 pszHeader 하기 AppendVaryByHeader때문에 IHttpCachePolicy 클라이언트는 에 대한 호출 후 를 pszHeader 삭제할 책임이 있습니다.
기본 IHttpCachePolicy 구현자가 사용하는 내부 버퍼는 사용자 지정 헤더의 쉼표로 구분된 문자열입니다. 따라서 는 pszHeader ',' 문자를 포함하지 않아야 합니다.
요구 사항
| 형식 | 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.5 - 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 |