CoInternetGetSecurityUrlEx function

Articolo
08/15/2017

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

Condividi tramite