This topic has not yet been rated - Rate this topic

Shell.ExplorerPolicy method

Gets the value for a specified Windows Internet Explorer policy.

Syntax


retVal = Shell.ExplorerPolicy(
  bstrPolicyName
)

Parameters

bstrPolicyName [in]

Type: BSTR

A String that specifies the name of the policy.

Return value

JScript

Type: Variant*

The value associated with the specified policy name.

VB

Type: Variant*

The value associated with the specified policy name.

Remarks

Network Administrators can control and manage the computing environment of their users by setting policies.

The specified value name must be within the HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\Explorer subkey. If the value name does not exist then the method returns null.

Examples

The following examples show the proper use of ExplorerPolicy for JScript, VBScript, and Visual Basic.

JScript:

none


<script language="JScript">
    function fnIShellDispatch4ExplorerPolicyJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var vReturn;
        
        vReturn = objshell.ExplorerPolicy("ValueName");
        alert(vReturn);
    }
</script>

VBScript:

<script language="VBScript">
     function fnIShellDispatch4ExplorerPolicyVB()
        dim objShell
        dim vReturn
        
        set objShell = CreateObject("shell.application")
            vReturn = objshell.ExplorerPolicy("ValueName")
            alert(vReturn)
        set objShell = nothing
    end function
 </script>

Visual Basic:

Private Sub fnIShellDispatch4ExplorerPolicyVB()
    Dim objShell As Shell
    Dim vReturn  As Variant
    
    Set objShell = New Shell
        vReturn = objshell.ExplorerPolicy("ValueName")
        Debug.Print vReturn
    Set objShell = Nothing
End Sub

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (version 6.0 or later)

Send comments about this topic to Microsoft

Build date: 11/28/2012

Community Additions

ADD