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;
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.
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.
Number of characters in the physical path.
Number of characters in the URL.
Reserved. Do not use.
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.