Share via


CoInternetGetSecurityUrlEx function

Gets the security URL for the Uniform Resource Identifier (URI) in the specified IUri.

Syntax

HRESULT CoInternetGetSecurityUrlEx(
             IUri      *pUri,
             IUri      **ppSecUri,
             PSUACTION psuAction,
  _Reserved_ DWORD_PTR dwReserved
);

Parameters

  • pUri
    A pointer to an IUri interface that describes the base URI.

  • ppSecUri
    A pointer to an IUri interface that receives the security URL.

  • psuAction
    A PSUACTION value that specifies what information is returned.

  • dwReserved
    Reserved. Must be set to 0.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

A security URL is a URI that is used by Windows Internet Explorer to make security decisions, such as mapping URLs to zones. This URI usually takes the following form.

scheme:domain

CoInternetGetSecurityUrlEx determines the protocol handler for the scheme, and invokes its IInternetProtocolInfo::ParseUrl implementation with the PARSE_SECURITY_URL flag. If the protocol is non-standard, and psuAction is set to PSU_DEFAULT, the handler is invoked again with the PARSE_SECURITY_DOMAIN flag.

This function is identical to the CoInternetGetSecurityUrl function, except that it uses IUri objects instead of URL strings.

Requirements

Minimum supported client

Windows XP with SP2

Minimum supported server

Windows Server 2003 with SP1

Product

Internet Explorer 7

Header

Urlmon.h

Library

Urlmon.lib

DLL

Urlmon.dll