Shell.IsRestricted-Methode

Ruft die Einschränkungseinstellung einer Gruppe aus der Registrierung ab.

Syntax

iRetVal = Shell.IsRestricted(
  sGroup,
  sRestriction
)

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

Parameter

sGroup [in]

Typ: BSTR

Eine Zeichenfolge , die den Gruppennamen enthält. Dieser Wert ist der Name eines Registrierungsunterschlüssels, unter dem die Einschränkung überprüft werden soll.

sRestriction [in]

Typ: BSTR

Eine Zeichenfolge , die die Einschränkung enthält, deren Wert abgerufen werden soll.

Rückgabewert

JScript

Typ: Integer*

Der Wert der Einschränkung. Wenn die angegebene Einschränkung nicht gefunden wird, ist der Rückgabewert 0.

VB

Typ: Integer*

Der Wert der Einschränkung. Wenn die angegebene Einschränkung nicht gefunden wird, ist der Rückgabewert 0.

Bemerkungen

IsRestricted sucht zuerst nach einem Unterschlüsselnamen, der sGroup unter dem folgenden Schlüssel entspricht.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies

Einschränkungen werden als Werte der einzelnen Richtlinienunterschlüssel deklariert. Wenn die Einschränkung mit dem Namen in sRestriction im Unterschlüssel in sGroup gefunden wird, gibt IsRestricted den aktuellen Wert der Einschränkung zurück. Wenn die Einschränkung unter HKEY_LOCAL_MACHINE nicht gefunden wird, wird derselbe Unterschlüssel unter HKEY_CURRENT_USER überprüft.

Diese Methode ist derzeit in Microsoft Visual Basic nicht verfügbar.

Beispiele

Die folgenden Beispiele zeigen die Verwendung von IsRestricted zum Abrufen des Datenwerts der Einschränkung undockwithoutlogon aus dem Unterschlüssel System . Die Verwendung wird für JScript und VBScript angezeigt.

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>

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (Version 5.0 oder höher)