Metode IHttpServer::D oCacheOperation

Melakukan operasi cache tertentu.

Sintaks

virtual HRESULT DoCacheOperation(  
   IN CACHE_OPERATION cacheOperation,  
   IN IHttpCacheKey* pCacheKey,  
   OUT IHttpCacheSpecificData** ppCacheSpecificData,  
   IN IHttpTraceContext* pHttpTraceContext = NULL  
) = 0;  

Parameter

cacheOperation
[IN] Nilai enumerasi CACHE_OPERATION .

pCacheKey
[IN] Penunjuk ke antarmuka IHttpCacheKey .

ppCacheSpecificData
[OUT] Penunjuk ke alamat antarmuka IHttpCacheSpecificData .

pHttpTraceContext
[IN] Penunjuk ke antarmuka IHttpTraceContext . (Opsional.)

Tampilkan Nilai

Sebuah HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Nilai	Deskripsi
S_OK	Menunjukkan bahwa operasi berhasil.

Keterangan

Metode DoCacheOperation ini digunakan dalam modul HTTP untuk melakukan operasi cache yang ditentukan oleh cacheOperation parameter . Misalnya, nilai enumerasi CACHE_OPERATION_ADD dan CACHE_OPERATION_DELETE masing-masing menyimpan atau menghapus objek, dari cache. Ketika modul Anda memanggil DoCacheOperation metode , modul harus meneruskan IHttpCacheKey antarmuka dalam pCacheKey parameter , dan IIS akan mengembalikan IHttpCacheSpecificData antarmuka dalam ppCacheSpecificData parameter . Anda dapat secara opsional menentukan IHttpTraceContext antarmuka dalam pHttpTraceContext parameter untuk mengidentifikasi permintaan yang memicu panggilan. (Ini hanya diperlukan untuk tujuan pelacakan.)

Catatan

Pelaksana tidak boleh memanggil DoCacheOperation di dalam IHttpApplicationResolveModulesProvider::RegisterModule Method karena terlalu dini dalam alur permintaan.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DoCacheOperation metode untuk membuat modul HTTP yang menguji operasi CACHE_OPERATION_RETRIEVE dan memicu operasi CACHE_OPERATION_ENUM .

#define _WINSOCKAPI_
#include <windows.h>
#include <sal.h>
#include <httpserv.h>

IHttpServer * g_pGlobalInfo;

// Create the module's global class.
class MyGlobalModule : public CGlobalModule
{
public:
    GLOBAL_NOTIFICATION_STATUS
    OnGlobalCacheOperation(
        IN ICacheProvider * pProvider
    )
    {
        if (CACHE_OPERATION_RETRIEVE == pProvider->GetCacheOperation())
        {
            // Retrieve an IHttpCacheKey interface.
            IHttpCacheKey * pCacheKey = pProvider->GetCacheKey();
            // Test for an error.
            if (NULL == pCacheKey) return GL_NOTIFICATION_CONTINUE;
            
            // Initialize an IHttpCacheSpecificData interface pointer.
            IHttpCacheSpecificData * pCacheSpecificData = NULL;
            
            // Peform a cache enumeration operation.
            HRESULT hr = g_pGlobalInfo->DoCacheOperation(
                CACHE_OPERATION_ENUM,pCacheKey,&pCacheSpecificData,NULL);
            
            // Test for an error.
            if (FAILED(hr)) return GL_NOTIFICATION_HANDLED;
        }

        // Return processing to the pipeline.
        return GL_NOTIFICATION_CONTINUE;
    }

    VOID Terminate()
    {
        // Remove the class from memory.
        delete this;
    }

};

// Create the module's exported registration function.
HRESULT
__stdcall
RegisterModule(
    DWORD dwServerVersion,
    IHttpModuleRegistrationInfo * pModuleInfo,
    IHttpServer * pGlobalInfo
)
{
    UNREFERENCED_PARAMETER( dwServerVersion );

    g_pGlobalInfo = pGlobalInfo;

    // Create an instance of the global module class.
    MyGlobalModule * pGlobalModule = new MyGlobalModule;
    // Test for an error.
    if (NULL == pGlobalModule)
    {
        return HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY);
    }
    // Set the global notifications and exit.
    return pModuleInfo->SetGlobalNotifications(
        pGlobalModule, GL_CACHE_OPERATION );
}

Modul Anda harus mengekspor fungsi RegisterModule . Anda dapat mengekspor fungsi ini dengan membuat file definisi modul (.def) untuk proyek Anda, atau Anda dapat mengkompilasi modul dengan menggunakan sakelar /EXPORT:RegisterModule . Untuk informasi selengkapnya, lihat Panduan: Membuat Modul HTTP Request-Level Dengan Menggunakan Kode Asli.

Anda dapat secara opsional mengkompilasi kode dengan menggunakan __stdcall (/Gz) konvensi panggilan alih-alih secara eksplisit mendeklarasikan konvensi panggilan untuk setiap fungsi.

Persyaratan

Jenis	Deskripsi
Klien	- IIS 7.0 di Windows Vista - IIS 7.5 di Windows 7 - IIS 8.0 di Windows 8 - IIS 10.0 pada Windows 10
Server	- IIS 7.0 di Windows Server 2008 - IIS 7.5 di Windows Server 2008 R2 - IIS 8.0 di Windows Server 2012 - IIS 8.5 di Windows Server 2012 R2 - IIS 10.0 di Windows Server 2016
Produk	- 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
Header	Httpserv.h

Lihat juga

Antarmuka IHttpServer
Enumerasi CACHE_OPERATION
Antarmuka IHttpCacheKey
Antarmuka IHttpCacheSpecificData
Antarmuka IHttpTraceContext