Método IShellDispatch2.IsRestricted

Recupera a configuração de restrição de um grupo do registro.

Sintaxe

iRetVal = IShellDispatch2.IsRestricted(
  sGroup,
  sRestriction
)

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

Parâmetros

sGroup [in]

Tipo: BSTR

Uma Cadeia de Caracteres que contém o nome do grupo. Esse valor é o nome de uma subchave do Registro sob a qual marcar para a restrição.

sRestriction [in]

Tipo: BSTR

Uma Cadeia de Caracteres que contém a restrição cujo valor deve ser recuperado.

Valor retornado

JScript

Tipo: Inteiro*

O valor da restrição. Se a restrição especificada não for encontrada, o valor retornado será 0.

VB

Tipo: Inteiro*

O valor da restrição. Se a restrição especificada não for encontrada, o valor retornado será 0.

Comentários

Esse método é implementado e acessado por meio do método Shell.IsRestricted .

IsRestricted procura primeiro um nome de subchave que corresponda a sGroup na chave a seguir.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies

As restrições são declaradas como valores das subchaves de política individuais. Se a restrição nomeada em sRestriction for encontrada na subchave chamada em sGroup, IsRestricted retornará o valor atual da restrição. Se a restrição não for encontrada em HKEY_LOCAL_MACHINE, a mesma subchave será verificada em HKEY_CURRENT_USER.

Esse método não está disponível no momento no Microsoft Visual Basic.

Exemplos

Os exemplos a seguir mostram o uso de IsRestricted para recuperar o valor de dados da restrição undockwithoutlogon da subchave System . O uso é mostrado para 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>

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (versão 5.0 ou posterior)