HTTP_FILTER_URL_MAP Structure (IIS)

  • Article

IIS includes a pointer to this structure when it maps a URL to a physical directory. If your filter should be notified for this event, it should register for the SF_NOTIFY_URL_MAP event.

typedef struct _HTTP_FILTER_URL_MAP HTTP_FILTER_URL_MAP {
      const CHAR * pszURL;
      CHAR * pszPhysicalPath;
      DWORD cbPathBuff;
} HTTP_FILTER_URL_MAP, * PHTTP_FILTER_URL_MAP;

Members

  • pszURL
    Points to the URL that is being mapped to a physical path.

  • pszPhysicalPath
    Points to the buffer where the physical path is stored.

  • cbPathBuff
    The size of the buffer pointed to by pszPhysicalPath.

Remarks

When the server is about to map the specified URL to a physical path, this structure is pointed to by the pvNotification parameter in the HttpFilterProc when the notificationType parameter is set to SF_NOTIFY_URL_MAP. Filters can modify the physical path in place (rather than copying it to a buffer, modifying it, and copying it back). When this event occurs it is too late in the server processing to use this filter notification to change a URL for a static file into an ISAPI or CGI request, or vice versa. If you need to make this change, you must use the SF_NOTIFY_PREPROC_HEADERS notification and change the URL value to modify the client request.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in httpfilt.h.

See Also