IShellDispatch2.IsRestricted 方法

從登錄擷取群組的限制設定。

語法

iRetVal = IShellDispatch2.IsRestricted(
  sGroup,
  sRestriction
)

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

參數

sGroup [in]

類型： BSTR

包含組名的 String 。 此值是要檢查限制的登錄子機碼名稱。

sRestriction [in]

類型： BSTR

String，其中包含要擷取其值的限制。

傳回值

JScript

類型： 整數*

限制的值。 如果找不到指定的限制，則傳回值為 0。

VB

類型： 整數*

限制的值。 如果找不到指定的限制，則傳回值為 0。

備註

此方法是透過 Shell.IsRestricted 方法實作和存取。

IsRestricted 會先尋找符合下列機碼下 sGroup 的子機碼名稱。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies

限制會宣告為個別原則子機碼的值。 如果在sGroup中名為 的子機碼中找到名為的限制，IsRestricted會傳回限制的目前值。 如果在 HKEY_LOCAL_MACHINE下找不到限制，則會在 HKEY_CURRENT_USER下檢查相同的子機碼。

這個方法目前無法在 Microsoft Visual Basic 中使用。

範例

下列範例示範如何使用IsRestricted從System子機碼擷取undockwithoutlogon限制的資料值。 JScript 和 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>

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	Shldisp.h
Idl	Shldisp.idl
DLL	Shell32.dll (5.0 版或更新版本)