HSE_REQ_SEND_URL

This support function allows your ISAPI extension to redirect a client browser to a different URL from the one they initially requested. When this support function is called, you must provide the new URL. IIS then sends the HTTP status code 302 (URL Redirect) to the client browser.

BOOL ServerSupportFunction(

  HCONN ConnID,  

  DWORD HSE_REQ_SEND_URL, 

  LPVOID lpvBuffer,  

  LPDWORD lpdwSize,  

  LPDWORD lpdwDataType

);

Parameters

ConnID

Specifies the connection identifier of the client to which the response data should be sent.

lpvBuffer

Points to a null-terminated string that contains the absolute URL that will serve as the source of the data to be sent to the browser.

lpdwSizeofBuffer

Points to the size of the buffer specified by lpvBuffer.

lpdwDataType

Unused in this ServerSupportFunction request type.

Remarks

Once this support function is called, no other tasks are required of your ISAPI extension to process the current request. An HTTP status code 302 response should force the browser to initiate a new connection with the new URL.

Note   In order to conform to the HTTP 1.1 specification (RFC 2068), it is important that the target URL be absolute. For example,

http://www.microsoft.com/default.asp

is a correct, absolute URL that should work with all HTTP 1.1-compliant browsers, whereas

default.asp

is a relative URL, and could be rejected by some browsers.

This support function is similar to the URL: <URL> syntax used CGI script headers to perform redirection.

Note that this support function is identical to HSE_REQ_SEND_URL_REDIRECT_RESP.