Método IHttpCachePolicy::SetVaryByValue

Define o valor da variável para a política de cache.

Sintaxe

virtual HRESULT SetVaryByValue(  
   PCSTR pszValue  
) = 0;  

Parâmetros

pszValue
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o valor personalizado a ser acrescentado.

-ou-

NULL.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor	Descrição
S_OK	Indica que a operação foi bem-sucedida.
E_INVALIDARG	Indica que pszValue é NULL.
ERROR_ARITHMETIC_OVERFLOW	Indica que o comprimento de pszValue excede um limite máximo.

Comentários

Classes derivadas de CHttpModule que se registram para eventos de solicitação ou resposta recebem um ponteiro IHttpContext como um parâmetro no método correspondentevirtual. Para definir o valor da variável, chame o método IHttpContext::GetResponse , o método IHttpResponse::GetCachePolicy e, por fim, o SetVaryByValue método .

SetVaryByValue O comportamento depende da implementação. Você deve usar as seguintes informações como uma diretriz, mas elas podem não estar corretas em todos os cenários:

• O implementador padrão atual da interface IHttpCachePolicy declara um private buffer que contém dados variáveis. Durante a construção de um implementador, esse buffer é inicializado como vazio.

• SetVaryByValue retornará E_INVALIDARG imediatamente se o pszValue parâmetro for NULL. Caso contrário, o buffer interno será expandido, se necessário, para manter o conteúdo de pszValue e o caractere de terminação nula. Em seguida pszValue, , seguido pelo caractere de terminação nula, é copiado para esse buffer. Todos os dados no buffer antes da chamada para SetVaryByValue são substituídos, se necessário, durante a chamada para SetVaryByValue.

Notas para implementadores

Os implementadores IHttpCachePolicy são responsáveis por copiar o pszValue parâmetro em um buffer, pois não há garantia de que os dados associados pszValue ao parâmetro sejam válidos após a chamada para SetVaryByValue.

Observações para chamadores

IHttpCachePolicy os clientes são responsáveis por passar uma cadeia de caracteres terminada em nulo para o SetVaryByValue método . Os clientes também são responsáveis por descartar pszValue após a chamada para SetVaryByValue, porque IHttpCachePolicy os implementadores copiam pszValue em um buffer interno.

Requisitos

Type	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Produto	- 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
parâmetro	Httpserv.h

Consulte Também

IHttpCachePolicy Interface