IHttpCachePolicy::SetVaryByValue 메서드

캐시 정책의 변수 값을 설정합니다.

구문

virtual HRESULT SetVaryByValue(  
   PCSTR pszValue  
) = 0;  

매개 변수

pszValue
추가할 사용자 지정 값을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

또는

NULL

반환 값

HRESULT입니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

값	설명
S_OK	작업이 성공했음을 나타냅니다.
E_INVALIDARG	가 NULL임을 pszValue 나타냅니다.
ERROR_ARITHMETIC_OVERFLOW	의 pszValue 길이가 최대 제한을 초과했음을 나타냅니다.

설명

요청 또는 응답 이벤트에 등록하는 CHttpModule 파생 클래스는 해당 virtual 메서드에 대한 매개 변수로 IHttpContext 포인터를 받습니다. 변수 값을 설정하려면 IHttpContext::GetResponse 메서드, IHttpResponse::GetCachePolicy 메서드를 호출하고 마지막으로 메서드를 SetVaryByValue 호출합니다.

SetVaryByValue 동작은 구현에 따라 달라집니다. 다음 정보를 지침으로 사용해야 하지만 모든 시나리오에서 올바르지 않을 수 있습니다.

• IHttpCachePolicy 인터페이스의 현재 기본 구현자는 변수 데이터가 포함된 버퍼를 private 선언합니다. 구현자를 생성하는 동안 이 버퍼는 비어 있는 것으로 초기화됩니다.

• SetVaryByValue 매개 변수가 pszValue NULL이면 즉시 E_INVALIDARG 반환합니다. 그렇지 않으면 필요한 경우 내부 버퍼가 확장되어 및 null 종료 문자의 pszValue 내용을 저장합니다. 그런 다음 pszValuenull 종료 문자 뒤에 이 버퍼에 복사됩니다. 에 대한 호출 전 버퍼의 모든 데이터는 필요한 경우 를 호출 SetVaryByValueSetVaryByValue하는 동안 덮어씁니다.

구현자에 대한 참고 사항

IHttpCachePolicy 구현자는 매개 변수를 호출한 후 매개 변수와 pszValue 연결된 데이터가 유효하지 않을 수 있으므로 매개 변수를 버퍼에 복사 pszValue 해야 합니다SetVaryByValue.

호출자 참고 사항

IHttpCachePolicy 클라이언트는 null로 끝나는 문자열을 메서드에 전달해야 합니다 SetVaryByValue . 구현자가 내부 버퍼에 복사 pszValue 되므로 SetVaryByValueIHttpCachePolicy 클라이언트는 에 대한 호출 후 를 pszValue 삭제할 책임이 있습니다.

요구 사항

형식	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

참고 항목

IHttpCachePolicy 인터페이스