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 |
|
| IDL |
|
| DLL |
|