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
Minimum supported client |
Windows XP with SP2 |
Minimum supported server |
Windows Server 2003 with SP1 |
Product |
Internet Explorer 7 |
Header |
Urlmon.h |
IDL |
Urlmon.idl |
DLL |
Urlmon.dll |