Metode IHttpRequest::SetUrl

Memodifikasi URL permintaan.

Sintaks

virtual HRESULT SetUrl(  
   IN PCWSTR pszUrl,  
   IN DWORD cchUrl,  
   IN BOOL fResetQueryString  
) = 0;  
  
virtual HRESULT SetUrl(  
   IN PCSTR pszUrl,  
   IN DWORD cchUrl,  
   IN BOOL fResetQueryString  
) = 0;  

Parameter

pszUrl
[IN] Penunjuk ke string yang berisi URL yang akan diatur.

cchUrl
[IN] Panjangnya, dalam karakter, dari URL yang ditentukan oleh pszUrl.

fResetQueryString
[IN] true untuk mengatur ulang string kueri 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_PARAMETER	Menunjukkan bahwa parameter yang ditentukan tidak valid (misalnya, URL yang ditentukan terlalu panjang).
ERROR_NOT_ENOUGH_MEMORY	Menunjukkan bahwa memori tidak cukup untuk melakukan operasi.

Keterangan

Metode memodifikasi SetUrl URL untuk permintaan saat ini. Ada dua versi metode yang SetUrl kelebihan beban. Satu memungkinkan Anda menentukan header dengan menggunakan penunjuk ke string. Kelebihan beban lainnya menggunakan penunjuk ke string lebar.

Fungsi pemrosesan permintaan dan operasi pengelogan berikutnya akan memproses URL baru seolah-olah klien telah meminta URL. Oleh karena itu, setiap kondisi kesalahan yang disebabkan oleh memodifikasi URL akan dikembalikan ke klien. Misalnya, jika URL baru tidak ada, server Web akan mengembalikan kesalahan HTTP 404.

Peringatan

Metode SetUrl ini dipanggil setelah parameter awal untuk permintaan dikumpulkan, sehingga pemrosesan permintaan berikutnya mungkin tidak menyadari URL yang diubah. Misalnya, mengambil variabel server URL akan mencerminkan permintaan asli, bukan URL yang diubah. Pelaksana harus memanggil Metode IHttpContext::ExecuteRequest alih-alih SetUrl menjalankan permintaan melalui alur lengkap. Metode SetUrl tidak boleh digunakan untuk penulisan ulang URL.

Catatan

Tidak seperti metode IHttpResponse::Redirect , SetUrl metode tidak mengalihkan klien ke URL baru.

Catatan

Anda harus memanggil SetUrl metode sebelum peristiwa pertama dalam alur pemrosesan permintaan terintegrasi HTTP. Memanggil SetUrl metode dari handler OnPostBeginRequest menghasilkan perilaku yang tidak ditentukan.

Contoh

Contoh kode berikut menunjukkan cara menggunakan SetUrl metode untuk mengubah URL yang diminta ke URL lain.

#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
    )
    {
        HRESULT hr;

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

        // Test for an error.
        if (pHttpRequest != NULL)
        {
            // Create a buffer with an example URL.
            PCSTR pszBuffer = "/example/default.aspx";
            // Set the URL for the request.
            hr = pHttpRequest->SetUrl(
                pszBuffer,(DWORD)strlen(pszBuffer),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;
        }            
    }

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

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::GetUrlChanged