Metode IHttpRequest::SetHeader

Mengatur atau menambahkan nilai header permintaan HTTP tertentu.

Sintaks

virtual HRESULT SetHeader(  
   IN PCSTR pszHeaderName,  
   IN PCSTR pszHeaderValue,  
   IN USHORT cchHeaderValue,  
   IN BOOL fReplace  
) = 0;  
  
virtual HRESULT SetHeader(  
   IN HTTP_HEADER_ID ulHeaderIndex,  
   IN PCSTR pszHeaderValue,  
   IN USHORT cchHeaderValue,  
   IN BOOL fReplace  
) = 0;  

Parameter

pszHeaderName
[IN] Penunjuk ke string yang berisi nama header HTTP yang akan diatur.

ulHeaderIndex
[IN] ID header HTTP yang akan diatur.

pszHeaderValue
[IN] Penunjuk ke string yang berisi nilai header yang akan diatur.

cchHeaderValue
[IN] Panjang, dalam karakter, dari nilai header, tidak termasuk karakter \0.

fReplace
[IN] true untuk menimpa header yang ada; jika tidak, false.

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.
ERROR_INVALID_DATA	Menunjukkan bahwa data tidak valid (misalnya, data di header terlalu panjang).
ERROR_INVALID_PARAMETER	Menunjukkan bahwa parameter yang ditentukan tidak valid (misalnya, parameternya adalah NULL).
ERROR_NOT_ENOUGH_MEMORY	Menunjukkan bahwa memori tidak cukup untuk melakukan operasi.

Keterangan

Metode SetHeader menetapkan nilai header HTTP untuk permintaan saat ini. Ada dua versi metode yang SetHeader kelebihan beban. Satu memungkinkan Anda menentukan header dengan menggunakan string yang terkandung dalam pszHeaderName parameter . Kelebihan beban lainnya menggunakan bilangan bulat panjang yang tidak ditandatangani yang terkandung dalam ulHeaderIndex parameter .

Nama header yang ditentukan oleh pszHeaderName parameter dapat menjadi header kustom atau header yang ditentukan dalam Request for Comments (RFC) 1945, "Hypertext Transfer Protocol -- HTTP/1.0," atau RFC 2616, "Hypertext Transfer Protocol -- HTTP/1.1."

Catatan

Parameter pszHeaderName tidak dapat diatur ke NULL.

Parameter ulHeaderIndex menentukan ID header HTTP yang tercantum dalam HTTP_HEADER_ID enumerasi.

Catatan

Enumerasi HTTP_HEADER_ID ditentukan dalam file header Http.h.

fReplace Jika parameter adalah true, nilai header yang ditentukan akan menggantikan nilai header yang ada jika header ada. Jika fReplace adalah false, Anda harus menambahkan nilai header yang ditentukan ke header yang ada dan memisahkan nilai dari header itu sendiri dengan koma.

Contoh

Contoh kode berikut menunjukkan cara menggunakan kedua kelebihan beban SetHeader metode untuk membuat modul HTTP yang menggantikan HTTP User-Agent dan Accept-Language header dengan nilai baru.

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

// Create the module class.
class MyHttpModule : public CHttpModule
{
public:
    REQUEST_NOTIFICATION_STATUS
    OnBeginRequest(
        IN IHttpContext * pHttpContext,
        IN IHttpEventProvider * pProvider
    )
    {
        UNREFERENCED_PARAMETER( pProvider );

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

        // Specify the "User-Agent" header name.
        char szHeaderName[] = "User-Agent";
        // Specify the "User-Agent" header value.
        char szUserAgent[] = "Test Browser";
        // Specify the "Accept-Language" header value.
        char szAcceptLanguage[] = "en-ie";

        // Retrieve a pointer to the request.
        IHttpRequest * pHttpRequest = pHttpContext->GetRequest();

        // Test for an error.
        if (pHttpRequest != NULL)
        {
            // Replace the "User-Agent" header.
            hr = pHttpRequest->SetHeader(
                szHeaderName,szUserAgent,
                (USHORT)strlen(szUserAgent),true);

            // Test for an error.
            if (FAILED(hr))
            {
                // Set the error status.
                pProvider->SetErrorStatus( hr );
                // End additional processing.
                return RQ_NOTIFICATION_FINISH_REQUEST;
            }

            // Replace the "Accept-language" header.
            hr = pHttpRequest->SetHeader(
                HttpHeaderAcceptLanguage,szAcceptLanguage,
                (USHORT)strlen(szAcceptLanguage),true);

            // 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;
    }
};

// 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;
        }            
    }
/* MERGEFORMAT 16 Aug 07  5:41 PM */
    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 );

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

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 IHttpRequest
Metode IHttpRequest::D eleteHeader
Metode IHttpRequest::GetHeader