IInternetZoneManagerEx2::GetZoneSecurityState method

Gets the security state of the specified zone.

Syntax

HRESULT GetZoneSecurityState(
  [in]      DWORD   dwZoneIndex,
  [in]      BOOL    fRespectPolicy,
  [in, out] LPDWORD pdwState,
  [in, out] BOOL    *pfPolicyEncountered
);

Parameters

dwZoneIndex [in]

An unsigned long integer value that specifies the zone index.

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]

The address of 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.

Return value

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

Remarks

GetZoneSecurityState 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

GetIESecurityState