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