IShellDispatch2.IsRestricted-Methode

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

Syntax

iRetVal = IShellDispatch2.IsRestricted(
  sGroup,
  sRestriction
)

IShellDispatch2.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

Diese Methode wird implementiert und über die Shell.IsRestricted-Methode aufgerufen.

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

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies

Einschränkungen werden als Werte der einzelnen Richtlinienunterschlüssel deklariert. Wenn die in sRestriction benannte Einschränkung im Unterschlüssel mit dem Namen 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.

Beispiele

In den folgenden Beispielen wird die Verwendung von IsRestricted zum Abrufen des Datenwerts der Einschränkung undockwithoutlogon aus dem Unterschlüssel System gezeigt. 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>

Requirements (Anforderungen)

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