IInternetZoneManagerEx2::GetIESecurityState method

Article
08/15/2017

Gets the security state of all zones.

Syntax

HRESULT GetIESecurityState(
  [in]      BOOL    fRespectPolicy,
  [in, out] LPDWORD pdwState,
  [in, out] BOOL    *pfPolicyEncountered,
  [in]      BOOL    fNoCache
);

Parameters

fRespectPolicy [in]

A boolean that specifies TRUE to skip template settings that are restricted by group policy.

pdwState [in, out]

The address of unsigned long integer variable that receives one of the following values.

SECURITY_IE_STATE_GREEN (0x00000000)

All settings are secure.

SECURITY_IE_STATE_RED (0x00000001)

One or more settings are insecure.

pfPolicyEncountered [in, out]

A boolean variable that receives TRUE if group policy overrides one or more of the template settings, or if security checks have been disabled. Can be set to NULL.

fNoCache [in]

A boolean that specifies whether to consult the in-memory cache of security settings.

Return value

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

Remarks

GetIESecurityState was introduced in Windows Internet Explorer 7.

Requirements

Minimum supported client	Windows XP with SP2
Minimum supported server	Windows Server 2003
Product	Internet Explorer 7
Header	Urlmon.h
IDL	Urlmon.idl
DLL	Urlmon.dll