IInternetZoneManagerEx2::GetIESecurityState method

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

See also

IInternetZoneManagerEx2

GetZoneSecurityState