IHttpCachePolicy::SetVaryByValue Method

Sets the variable value for the cache policy.

Syntax

virtual HRESULT SetVaryByValue(  
   PCSTR pszValue  
) = 0;  

Parameters

pszValue
A pointer to a null-terminated string that contains the custom value to append.

-or-

NULL.

Return Value

An HRESULT. Possible values include, but are not limited to, those in the following table.

Remarks

CHttpModule derived classes that register for request or response events receive an IHttpContext pointer as a parameter on the corresponding virtual method. To set the variable value, call the IHttpContext::GetResponse method, the IHttpResponse::GetCachePolicy method, and finally the SetVaryByValue method.

SetVaryByValue behavior depends on implementation. You should use the following information as a guideline, but it may not be correct in all scenarios:

• The current default implementer of the IHttpCachePolicy interface declares a private buffer that contains variable data. During the construction of an implementer, this buffer is initialized to empty.

• SetVaryByValue returns E_INVALIDARG immediately if the pszValue parameter is NULL. Otherwise, the internal buffer is expanded, if necessary, to hold the contents of pszValue and the null-termination character. Then pszValue, followed by the null-termination character, is copied into this buffer. Any data in the buffer before the call to SetVaryByValue is overwritten, if necessary, during the call to SetVaryByValue.

Notes for Implementers

IHttpCachePolicy implementers are responsible for copying the pszValue parameter into a buffer, because the data associated with the pszValue parameter is not guaranteed to be valid after the call to SetVaryByValue.

Notes for Callers

IHttpCachePolicy clients are responsible for passing a null-terminated string to the SetVaryByValue method. Clients are also responsible for disposing of pszValue after the call to SetVaryByValue, because IHttpCachePolicy implementers copy pszValue into an internal buffer.

Requirements

See Also

IHttpCachePolicy Interface