Compartilhar via


Método IHttpCacheSpecificData::ResetTTL

Redefine a configuração TTL (vida útil) dos dados armazenados em cache.

Sintaxe

virtual VOID ResetTTL(  
   VOID  
) = 0;  

Parâmetros

Este método não aceita parâmetros.

Acesso thread-safe

As classes que implementam a interface IHttpCacheSpecificData são thread-safe para os métodos DecrementTTL e ResetTTL .

Comentários

O TTL é usado para determinar quando os dados armazenados em cache não são mais válidos e, portanto, quando esses dados devem ser recarregados. A maioria das IHttpCacheSpecificData implementações define uma contagem interna inicial como um valor positivo e permite que essa contagem seja reduzida por meio de chamadas sucessivas para o DecrementTTL método . Se o valor de TTL se tornar 0, os dados deverão ser recarregados.

O comportamento do ResetTTL método é específico 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:

  • As classes que implementam as IHttpCacheSpecificData interfaces ou IHttpTokenEntry inicializam a contagem interna como 2 na construção e decrementam que contam em 1 em cada chamada para DecrementTTL.

  • As classes que implementam a interface IHttpFileInfo são variadas. Algumas classes implementam o esquema definido acima, enquanto outras executam operações vazias em ResetTTL e DecrementTTL.

Notas para implementadores

As implementações do DecrementTTL método e ResetTTL devem ser thread-safe para um IHttpCacheSpecificData ponteiro.

Observações para chamadores

A maioria dos chamadores pode desconsiderar o ResetTTL método porque esse método deve ser usado internamente.

Exemplo

O exemplo de código a seguir demonstra uma classe chamada MySpecificData que implementa os IHttpCacheSpecificData métodos .

class MySpecificData : public IHttpCacheSpecificData  
{  
public:  
    MySpecificData()  
    {  
        m_ttl = 2;  
    }  
  
    virtual ~MySpecificData()  
    {  
        m_ttl = 0;  
    }  
  
    virtual VOID ResetTTL(VOID)  
    {  
        m_ttl = 2;  
    }  
  
    virtual VOID DecrementTTL(BOOL* pfTTLExpired)  
    {  
        *pfTTLExpired = (InterlockedDecrement(&m_ttl) == 0);  
    }  
  
private:  
    LONG m_ttl;  
};  

Requisitos

Tipo 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

IHttpCacheSpecificData Interface