RegistryPermission.SetPathList メソッド

.NET Framework クラス ライブラリ リファレンス

RegistryPermission.SetPathList メソッド

指定したレジストリ変数名への新しいアクセスを、アクセス許可の既存の状態に設定します。

名前空間: System.Security.Permissions
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub SetPathList ( _
    access As RegistryPermissionAccess, _
    pathList As String _
)

Visual Basic (使用法)

Dim instance As RegistryPermission
Dim access As RegistryPermissionAccess
Dim pathList As String

instance.SetPathList(access, pathList)

C#

public void SetPathList (
    RegistryPermissionAccess access,
    string pathList
)

C++

public:
void SetPathList (
    RegistryPermissionAccess access, 
    String^ pathList
)

J#

public void SetPathList (
    RegistryPermissionAccess access, 
    String pathList
)

JScript

public function SetPathList (
    access : RegistryPermissionAccess, 
    pathList : String
)

パラメータ

access

RegistryPermissionAccess 値の 1 つ。

pathList

レジストリ変数の (セミコロン区切りの) リスト。

例外

例外の種類	条件
ArgumentException	access パラメータが、RegistryPermissionAccess の有効値ではありません。 または pathList パラメータが、有効な文字列ではありません。

解説

現在のアクセス許可の以前の状態は上書きされます。

使用例

SetPathList メソッドを使用するコード例を次に示します。このコード例は、RegistryPermission クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' AddPathList adds access for the specified registry variables to the
 existing state of the permission.
' SetPathList sets new access for the specified registry variable names
 to the existing state of the permission.
' GetPathList gets paths for all registry variables with the specified
 RegistryPermissionAccess.
Private Function SetGetPathListDemo() As
 Boolean
    Try
        Console.WriteLine("********************************************************"
 + vbLf)

        Dim readPerm1 As RegistryPermission
        Console.WriteLine("Creating RegistryPermission with
 AllAccess rights for 'HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0'")
        readPerm1 = New RegistryPermission(RegistryPermissionAccess.AllAccess,
 "HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0")
        Console.WriteLine("Adding 'HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION'
 to the write access list, " + "and " + vbLf + " 'HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\FloatingPointProcessor\0'
 " + "to the read access list.")
        readPerm1.AddPathList(RegistryPermissionAccess.Write, "HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION")
        readPerm1.AddPathList(RegistryPermissionAccess.Read, "HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\FloatingPointProcessor\0")
        Console.WriteLine("Read access list before SetPathList
 = " + readPerm1.GetPathList(RegistryPermissionAccess.Read))
        Console.WriteLine("Setting read access rights to "
 + vbLf + "'HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0'")
        readPerm1.SetPathList(RegistryPermissionAccess.Read, "HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0")
        Console.WriteLine("Read access list after SetPathList
 = " + vbLf + readPerm1.GetPathList(RegistryPermissionAccess.Read))
        Console.WriteLine("Write access = " + vbLf
 + readPerm1.GetPathList(RegistryPermissionAccess.Write))
        Console.WriteLine("Write access Registry variables = "
 + vbLf + readPerm1.GetPathList(RegistryPermissionAccess.AllAccess))
    Catch e As ArgumentException
        ' RegistryPermissionAccess.AllAccess can not be used as a parameter
 for GetPathList.
        Console.WriteLine("An ArgumentException occured as a result
 of using AllAccess. " + _
        "AllAccess cannot be used as a parameter in GetPathList
 because it represents more than one " + _
        "type of registry variable access : " + vbLf
 + e.Message)
    End Try

    Return True

End Function 'SetGetPathListDemo

C#

// AddPathList adds access for the specified registry variables to the
 existing state of the permission.
// SetPathList sets new access for the specified registry variable names
 to the existing state of the permission.
// GetPathList gets paths for all registry variables with the specified
 RegistryPermissionAccess.
private bool SetGetPathListDemo()
{
    try
    {
        Console.WriteLine("********************************************************\n");

        RegistryPermission readPerm1;
        Console.WriteLine("Creating RegistryPermission with AllAccess rights
 for 'HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\CentralProcessor\\0'");
        readPerm1 = new RegistryPermission(RegistryPermissionAccess.AllAccess,
 "HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\CentralProcessor\\0");
        Console.WriteLine("Adding 'HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION'
 to the write access list, "
            + "and \n 'HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\FloatingPointProcessor\\0'
 "
            + "to the read access list.");
        readPerm1.AddPathList(RegistryPermissionAccess.Write, "HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION");
        readPerm1.AddPathList(RegistryPermissionAccess.Read,
            "HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\FloatingPointProcessor\\0");
        Console.WriteLine("Read access list before SetPathList = " +
            readPerm1.GetPathList(RegistryPermissionAccess.Read));
        Console.WriteLine("Setting read access rights to \n'HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\CentralProcessor\\0'");
        readPerm1.SetPathList(RegistryPermissionAccess.Read,
            "HKEY_LOCAL_MACHINE\\HARDWARE\\DESCRIPTION\\System\\CentralProcessor\\0");
        Console.WriteLine("Read access list after SetPathList = \n" +
            readPerm1.GetPathList(RegistryPermissionAccess.Read));
        Console.WriteLine("Write access = \n" +
            readPerm1.GetPathList(RegistryPermissionAccess.Write));
        Console.WriteLine("Write access Registry variables = \n" +
            readPerm1.GetPathList(RegistryPermissionAccess.AllAccess));
    }
    catch (ArgumentException e)
    {
        // RegistryPermissionAccess.AllAccess can not be used as a parameter
 for GetPathList.
        Console.WriteLine("An ArgumentException occured as a result of using
 AllAccess. "
            + "AllAccess cannot be used as a parameter in
 GetPathList because it represents more than one "
            + "type of registry variable access : \n" + e);
    }

    return true;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
RegistryPermission クラス
RegistryPermission メンバ
System.Security.Permissions 名前空間