IShellDispatch2.IsRestricted メソッド

レジストリからグループの制限設定を取得します。

構文

iRetVal = IShellDispatch2.IsRestricted(
  sGroup,
  sRestriction
)

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

パラメーター

sGroup [in]

種類: BSTR

グループ名を含む 文字列 。 この値は、制限をチェックするレジストリ サブキーの名前です。

sRestriction [in]

種類: BSTR

値を取得する制限を含む String 。

戻り値

JScript

型: Integer*

制限の値です。 指定した制限が見つからない場合、戻り値は 0 です。

VB

型: Integer*

制限の値です。 指定した制限が見つからない場合、戻り値は 0 です。

解説

このメソッドは、 Shell.IsRestricted メソッドを使用して実装され、アクセスされます。

IsRestricted は、最初に、次のキーの 下にある sGroup と一致するサブキー名を検索します。

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Policies

制限は、個々のポリシー サブキーの値として宣言されます。 sGroup で という名前のサブキーに sRestriction で指定された制限が見つかった場合、IsRestricted は制限の現在の値を返します。 HKEY_LOCAL_MACHINEで制限が見つからない場合は、HKEY_CURRENT_USERで同じサブキーがチェックされます。

現在、このメソッドは Microsoft Visual Basic では使用できません。

例

次の例は、IsRestricted を使用して、システム サブキーから 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 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Shldisp.h
IDL	Shldisp.idl
[DLL]	Shell32.dll (バージョン 5.0 以降)