IHttpServer：:D oCacheOperation 方法

執行特定的快取作業。

語法

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

參數

cacheOperation
[IN] CACHE_OPERATION 列舉值。

pCacheKey
[IN] IHttpCacheKey 介面的指標。

ppCacheSpecificData
[OUT] IHttpCacheSpecificData 介面位址的指標。

pHttpTraceContext
[IN] IHttpTraceCoNtext 介面的指標。 (選擇性。)

傳回值

HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

備註

方法 DoCacheOperation 用於 HTTP 模組中，以執行 參數所 cacheOperation 指定的快取作業。 例如， CACHE_OPERATION_ADD 和 CACHE_OPERATION_DELETE 列舉值會分別儲存或移除快取中的物件。 當您的模組呼叫 DoCacheOperation 方法時，它必須在 參數中 pCacheKey 傳遞 IHttpCacheKey 介面，而 IIS 會傳回 IHttpCacheSpecificData 參數中的 ppCacheSpecificData 介面。 您可以選擇性地在 參數中 pHttpTraceContext 指定 IHttpTraceContext 介面，以識別觸發呼叫的要求。 (這僅適用于追蹤用途。)

範例

下列程式碼範例示範如何使用 DoCacheOperation 方法來建立 HTTP 模組，以測試 CACHE_OPERATION_RETRIEVE 作業，並觸發 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 );
}

您的模組必須匯出 RegisterModule 函式 。 您可以為專案建立模組定義 (.def) 檔案，或使用 參數編譯模組 /EXPORT:RegisterModule 來匯出此函式。 如需詳細資訊，請參閱逐步解說 ：使用機器碼建立Request-Level HTTP 模組。

您可以選擇性地使用呼叫慣例編譯器代碼， __stdcall (/Gz) 而不是明確宣告每個函式的呼叫慣例。

規格需求

另請參閱

IHttpServer 介面
CACHE_OPERATION列舉
IHttpCacheKey 介面
IHttpCacheSpecificData 介面
IHttpTraceCoNtext 介面