IInternetSecurityManagerEx2::MapUrlToZoneEx2 method

Gets the zone index for the specified URL.

Syntax

HRESULT MapUrlToZoneEx2(
  [in]  IUri   *pUri,
  [out] DWORD  *pdwZone,
  [in]  DWORD  dwFlags,
  [out] LPWSTR *ppwszMappedUrl,
  [out] DWORD  *pdwOutFlags
);

Parameters

pUri [in]

A pointer to an IUri interface that contains the URL. Compare to MapUrlToZone.

pdwZone [out]

A DWORD that receives the zone index.

dwFlags [in]

A DWORD value that specifies MapUrlToZone Flags to control the mapping.

ppwszMappedUrl [out]

The address of the LPWSTR variable in which the mapped URL is returned. May be NULL.

pdwOutFlags [out]

The address of DWORD that receives the returned flags, if any, or NULL.

MUTZ_FREEMARKEDURL (0x80000000)

If set, the memory in pdwOutFlags must be freed by the caller with LocalFree.

Return value

Returns E_INVALIDARG if pUri or pdwZone is set to NULL, or if MUTZ_NOSAVEDFILECHECK and MUTZ_REQUIRESAVEDFILECHECK are both set. Returns S_OK otherwise.

Remarks

IInternetSecurityManagerEx2::MapUrlToZoneEx2 was introduced in Windows Internet Explorer 7.

Security Warning:  Incorrect implementation of this method can compromise the security of your application. A custom implementation of IInternetSecurityManagerEx2::MapUrlToZoneEx2 should return only zones for URLs that the default application cannot or should not handle. For all other URLs, this method should return INET_E_DEFAULT_ACTION. An attempt to duplicate the default implementation can result in the incorrect mapping of zones and might leave users susceptible to spoofing or elevation of privilege attacks. Review Security Considerations: URL Security Zones API before you continue.

Requirements

See also

IInternetSecurityManagerEx2