ISendResponseProvider::SetLogData, méthode

Article
07/19/2023

Configure les informations de journalisation pour la réponse actuelle.

Syntaxe

virtual HRESULT SetLogData(  
   IN VOID* pLogData  
) = 0;

Paramètres

pLogData
[IN] Pointeur vers VOID.

Valeur renvoyée

Élément HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Valeur	Description
S_OK	Indique que l’opération a réussi.

Remarques

Vous pouvez utiliser la méthode pour modifier les SetLogData valeurs qu’IIS écrira dans un fichier journal. Pour utiliser cette méthode dans un module HTTP, votre module doit d’abord appeler la méthode ISendResponseProvider::GetReadyToLogData pour vérifier qu’IIS est prêt à journaliser les informations, puis appeler la méthode ISendResponseProvider::GetLogData pour récupérer un VOID pointeur que vous allez convertir vers une structure HTTP_LOG_FIELDS_DATA .

Notes

La HTTP_LOG_FIELDS_DATA structure est définie dans le fichier d’en-tête Http.h.

Vous pouvez utiliser la HTTP_LOG_FIELDS_DATA structure pour modifier l’une des valeurs journalisée par IIS (par exemple, le nom du serveur ou la chaîne de l’agent utilisateur du client). Une fois que vous avez terminé de modifier les valeurs du journal, vous utilisez SetLogData pour envoyer vos valeurs modifiées à IIS.

Exemple

L’exemple de code suivant montre comment créer un module HTTP qui utilise la GetReadyToLogData méthode pour déterminer si IIS contient des informations de journal prêtes. Le module effectue les étapes suivantes :

Utilise la GetLogData méthode pour récupérer une HTTP_LOG_FIELDS_DATA structure.
Utilise cette structure pour récupérer le nom du serveur à partir des informations du journal.
Modifie le port du serveur dans l’entrée du journal.
Utilise la SetLogData méthode pour envoyer les informations de journal modifiées à IIS.
Retourne le nom du serveur à un client Web, puis se ferme.

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

// Create the module class.
class MyHttpModule : public CHttpModule
{
public:
    REQUEST_NOTIFICATION_STATUS
    OnSendResponse(
        IN IHttpContext * pHttpContext,
        IN ISendResponseProvider * pProvider
    )
    {
        
        // Retrieve log status.
        if (TRUE == pProvider->GetReadyToLogData())
        {
            // Retrieve log information.
            PHTTP_LOG_FIELDS_DATA pLogData =
                (PHTTP_LOG_FIELDS_DATA) pProvider->GetLogData();
            // Test for an error.
            if (NULL != pLogData)
            {
                // Clear the existing response.
                pHttpContext->GetResponse()->Clear();
                // Set the MIME type to plain text.
                pHttpContext->GetResponse()->SetHeader(
                    HttpHeaderContentType,"text/plain",
                    (USHORT)strlen("text/plain"),TRUE);
                // Return the server name.
                WriteResponseMessage(pHttpContext,
                    "Server name: ",pLogData->ServerName);
                // Modify the port number.
                pLogData->ServerPort = 8080;
                // Set the log data.
                HRESULT hr = pProvider->SetLogData(pLogData);
                // Test for an error.
                if (FAILED(hr))
                {
                    // Set the error status.
                    pProvider->SetErrorStatus( hr );
                    // End additional processing.
                    return RQ_NOTIFICATION_FINISH_REQUEST;
                }
            }
        }
        // Return processing to the pipeline.
        return RQ_NOTIFICATION_CONTINUE;
    }

private:

    // Create a utility method that inserts a name/value pair into the response.
    HRESULT WriteResponseMessage(
        IHttpContext * pHttpContext,
        PCSTR pszName,
        PCSTR pszValue
    )
    {
        // Create an HRESULT to receive return values from methods.
        HRESULT hr;
        
        // Create a data chunk.
        HTTP_DATA_CHUNK dataChunk;
        // Set the chunk to a chunk in memory.
        dataChunk.DataChunkType = HttpDataChunkFromMemory;
        // Buffer for bytes written of data chunk.
        DWORD cbSent;

        // Set the chunk to the first buffer.
        dataChunk.FromMemory.pBuffer =
            (PVOID) pszName;
        // Set the chunk size to the first buffer size.
        dataChunk.FromMemory.BufferLength =
            (USHORT) strlen(pszName);
        // Insert the data chunk into the response.
        hr = pHttpContext->GetResponse()->WriteEntityChunks(
            &dataChunk,1,FALSE,TRUE,&cbSent);
        // Test for an error.
        if (FAILED(hr))
        {
            // Return the error status.
            return hr;
        }

        // Set the chunk to the second buffer.
        dataChunk.FromMemory.pBuffer =
            (PVOID) pszValue;
        // Set the chunk size to the second buffer size.
        dataChunk.FromMemory.BufferLength =
            (USHORT) strlen(pszValue);
        // Insert the data chunk into the response.
        hr = pHttpContext->GetResponse()->WriteEntityChunks(
            &dataChunk,1,FALSE,TRUE,&cbSent);
        // Test for an error.
        if (FAILED(hr))
        {
            // Return the error status.
            return hr;
        }

        // Return a success status.
        return S_OK;
    }
};

// Create the module's class factory.
class MyHttpModuleFactory : public IHttpModuleFactory
{
public:
    HRESULT
    GetHttpModule(
        OUT CHttpModule ** ppModule, 
        IN IModuleAllocator * pAllocator
    )
    {
        UNREFERENCED_PARAMETER( pAllocator );

        // Create a new instance.
        MyHttpModule * pModule = new MyHttpModule;

        // Test for an error.
        if (!pModule)
        {
            // Return an error if the factory cannot create the instance.
            return HRESULT_FROM_WIN32( ERROR_NOT_ENOUGH_MEMORY );
        }
        else
        {
            // Return a pointer to the module.
            *ppModule = pModule;
            pModule = NULL;
            // Return a success status.
            return S_OK;
        }            
    }

    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 );
    UNREFERENCED_PARAMETER( pGlobalInfo );

    // Create an HRESULT to receive return values from methods.
    HRESULT hr;

    // Set the request priority.
    hr = pModuleInfo->SetPriorityForRequestNotification(
        RQ_SEND_RESPONSE,PRIORITY_ALIAS_HIGH);

    // Test for an error and exit if necessary.
    if (FAILED(hr))
    {
        return hr;
    }

    // Set the request notifications and exit.
    return pModuleInfo->SetRequestNotifications(
        new MyHttpModuleFactory,
        RQ_SEND_RESPONSE,
        0
    );
}

Votre module doit exporter la fonction RegisterModule . Vous pouvez exporter cette fonction en créant un fichier de définition de module (.def) pour votre projet, ou vous pouvez compiler le module à l’aide du /EXPORT:RegisterModule commutateur. Pour plus d’informations, consultez Procédure pas à pas : création d’un module HTTP Request-Level à l’aide de code natif.

Vous pouvez éventuellement compiler le code à l’aide de la __stdcall (/Gz) convention d’appel au lieu de déclarer explicitement la convention d’appel pour chaque fonction.

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- 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
En-tête	Httpserv.h

Voir aussi

ISendResponseProvider, interface
ISendResponseProvider::GetLogData, méthode

Partager via