Share via

HSE_URL_MAPEX_INFO Structure

  • Article

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.