HSE_URL_MAPEX_INFO Structure

You can use this structure with the HSE_REQ_MAP_URL_TO_PATH_EX function of the ServerSupportFunction. The structure returns information regarding a virtual root that is to be mapped to a physical path.

typedef struct _HSE_URL_MAPEX_INFO HSE_URL_MAPEX_INFO {
   CHAR lpszPath[MAX_PATH];
   DWORD dwFlags;
   DWORD cchMatchingPath;
   DWORD cchMatchingURL;
   DWORD dwReserved1;
   DWORD dwReserved2;
} HSE_URL_MAPEX_INFO, * LPHSE_URL_MAPEX_INFO;

Members

lpszPath[MAX_PATH]

The physical path that the virtual root maps to. The size of this path is limited to MAX_PATH. Path lengths that are longer than MAX_PATH are truncated. In IIS 6.0, GetLastError returns ERROR_INSUFFICIENT_BUFFER if the path is truncated. In IIS 5.1, no error is returned.

dwFlags

Access permissions associated with the URL. This data comes from the AccessPerm property in the metabase node for the URL. Indicates if the URL has read, write, or execute permissions, and if encryption is required. The dwFlags value can be one of the following:

Value	Meaning
HSE_URL_FLAGS_READ	Allow for read.
HSE_URL_FLAGS_WRITE	Allow for write.
HSE_URL_FLAGS_EXECUTE	Allow for execute.
HSE_URL_FLAGS_SSL	Require SSL.
HSE_URL_FLAGS_DONT_CACHE	Don't cache (virtual root only).
HSE_URL_FLAGS_NEGO_CERT	Allow client SSL certifications.
HSE_URL_FLAGS_REQUIRE_CERT	Require client SSL certifications.
HSE_URL_FLAGS_MAP_CERT	Map SSL certification to a Windows account.
HSE_URL_FLAGS_SSL128	Requires a 128-bit SSL.
HSE_URL_FLAGS_SCRIPT	Allows for script execution.

cchMatchingPath

Number of characters in the physical path.

cchMatchingURL

Number of characters in the URL.

dwReserved1

Reserved. Do not use.

dwReserved2

Reserved. Do not use.

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 httpext.h.