Método IShellDispatch2.IsRestricted

Recupera la configuración de restricción de un grupo del Registro.

Sintaxis

iRetVal = IShellDispatch2.IsRestricted(
  sGroup,
  sRestriction
)

IShellDispatch2.IsRestricted( _
  ByVal sGroup As BSTR, _
  ByVal sRestriction As BSTR _
) As Integer

Parámetros

sGroup [in]

Tipo: BSTR

Cadena que contiene el nombre del grupo. Este valor es el nombre de una subclave del Registro en la que se va a comprobar la restricción.

sRestriction [in]

Tipo: BSTR

Cadena que contiene la restricción cuyo valor se va a recuperar.

Valor devuelto

JScript

Tipo: Entero*

Valor de la restricción. Si no se encuentra la restricción especificada, el valor devuelto es 0.

VB

Tipo: Entero*

Valor de la restricción. Si no se encuentra la restricción especificada, el valor devuelto es 0.

Comentarios

Este método se implementa y se accede a él mediante el método Shell.IsRestricted .

IsRestricted busca primero un nombre de subclave que coincida con sGroup en la clave siguiente.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies

Las restricciones se declaran como valores de las subclaves de directiva individuales. Si la restricción denominada en sRestriction se encuentra en la subclave denominada en sGroup, IsRestricted devuelve el valor actual de la restricción. Si no se encuentra la restricción en HKEY_LOCAL_MACHINE, la misma subclave se comprueba en HKEY_CURRENT_USER.

Este método no está disponible actualmente en Microsoft Visual Basic.

Ejemplos

En los ejemplos siguientes se muestra el uso de IsRestricted para recuperar el valor de datos de la restricción undockwithoutlogon de la subclave Sistema . El uso se muestra para JScript y VBScript.

Jscript:

<script language="JScript">
    function fnIsRestricedJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var lReturn;
        
        lReturn = objShell.IsRestricted("system", "undockwithoutlogon");
        document.write(lReturn);
    }
</script>

Vbscript:

<script language="VBScript">
    function fnIsRestricedVB()
        dim objShell
        dim lReturn

        set objShell = CreateObject("shell.application")

        lReturn = objShell.IsRestricted("system", "undockwithoutlogon")
        document.write(lReturn)

        set objShell = nothing
    end function
</script>

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Shldisp.h
IDL	Shldisp.idl
Archivo DLL	Shell32.dll (versión 5.0 o posterior)