Metodo IShellDispatch2.IsRestricted

Recupera l'impostazione di restrizione di un gruppo dal Registro di sistema.

Sintassi

iRetVal = IShellDispatch2.IsRestricted(
  sGroup,
  sRestriction
)

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

Parametri

sGroup [in]

Tipo: BSTR

Stringa contenente il nome del gruppo. Questo valore è il nome di una sottochiave del Registro di sistema in cui verificare la restrizione.

sRestriction [in]

Tipo: BSTR

Stringa che contiene la restrizione il cui valore deve essere recuperato.

Valore restituito

JScript

Tipo: Integer*

Valore della restrizione. Se la restrizione specificata non viene trovata, il valore restituito è 0.

VB

Tipo: Integer*

Valore della restrizione. Se la restrizione specificata non viene trovata, il valore restituito è 0.

Commenti

Questo metodo viene implementato e accessibile tramite il metodo Shell.IsRestricted .

IsRestricted cerca innanzitutto un nome di sottochiave corrispondente a sGroup nella chiave seguente.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies

Le restrizioni vengono dichiarate come valori delle singole sottochiave dei criteri. Se la restrizione denominata in sRestriction viene trovata nella sottochiave denominata in sGroup, IsRestricted restituisce il valore corrente della restrizione. Se la restrizione non viene trovata in HKEY_LOCAL_MACHINE, la stessa sottochiave viene selezionata in HKEY_CURRENT_USER.

Questo metodo non è attualmente disponibile in Microsoft Visual Basic.

Esempio

Negli esempi seguenti viene illustrato l'uso di IsRestricted per recuperare il valore dei dati della restrizione undockwithoutlogon dalla sottochiave Di sistema . L'utilizzo viene visualizzato per JScript e 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>

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (versione 5.0 o successiva)