RegistryPermission.AddPathList Metodo

Definizione

Spazio dei nomi:

System.Security.Permissions

Assembly:

System.Security.Permissions.dll

Aggiunge allo stato esistente dell'autorizzazione l'accesso alle variabili del Registro di sistema specificate.

Overload

AddPathList(RegistryPermissionAccess, String)	Aggiunge allo stato esistente dell'autorizzazione l'accesso alle variabili del Registro di sistema specificate.
AddPathList(RegistryPermissionAccess, AccessControlActions, String)	Aggiunge allo stato esistente dell'autorizzazione l'accesso alle variabili del Registro di sistema specificate, indicando l'accesso all'autorizzazione del Registro di sistema e le azioni di controllo dell'accesso.

Commenti

Usare questo metodo per modificare l'accesso alle variabili del Registro di sistema aggiungendo il set dei percorsi allo stato dell'oggetto di autorizzazione corrente.

AddPathList(RegistryPermissionAccess, String)

Aggiunge allo stato esistente dell'autorizzazione l'accesso alle variabili del Registro di sistema specificate.

public:
 void AddPathList(System::Security::Permissions::RegistryPermissionAccess access, System::String ^ pathList);

public void AddPathList (System.Security.Permissions.RegistryPermissionAccess access, string pathList);

member this.AddPathList : System.Security.Permissions.RegistryPermissionAccess * string -> unit

Public Sub AddPathList (access As RegistryPermissionAccess, pathList As String)

Parametri

access

RegistryPermissionAccess

Uno dei valori di RegistryPermissionAccess.

pathList

String

Elenco di variabili del Registro di sistema (delimitato da punto e virgola).

Eccezioni

ArgumentException

Il parametro access non è un valore valido di RegistryPermissionAccess.

-oppure-

Il parametro pathList non è una stringa valida.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso AddPathList(RegistryPermissionAccess, String) del metodo.

// 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 static 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 occurred 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;
}

' 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 Shared 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 occurred 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

Commenti

Usare questo metodo per modificare l'accesso alle variabili del Registro di sistema aggiungendo allo stato dell'oggetto di autorizzazione corrente.

AddPathList(RegistryPermissionAccess, AccessControlActions, String)

Aggiunge allo stato esistente dell'autorizzazione l'accesso alle variabili del Registro di sistema specificate, indicando l'accesso all'autorizzazione del Registro di sistema e le azioni di controllo dell'accesso.

public:
 void AddPathList(System::Security::Permissions::RegistryPermissionAccess access, System::Security::AccessControl::AccessControlActions actions, System::String ^ pathList);

public void AddPathList (System.Security.Permissions.RegistryPermissionAccess access, System.Security.AccessControl.AccessControlActions actions, string pathList);

member this.AddPathList : System.Security.Permissions.RegistryPermissionAccess * System.Security.AccessControl.AccessControlActions * string -> unit

Public Sub AddPathList (access As RegistryPermissionAccess, actions As AccessControlActions, pathList As String)

Parametri

access

RegistryPermissionAccess

Uno dei valori di RegistryPermissionAccess.

actions

AccessControlActions

Uno dei valori di AccessControlActions.

pathList

String

Elenco di variabili del Registro di sistema (delimitato da punto e virgola).

Eccezioni

ArgumentException

Il parametro access non è un valore valido di RegistryPermissionAccess.

-oppure-

Il parametro pathList non è una stringa valida.

Commenti

Usare questo metodo per modificare l'accesso alle variabili del Registro di sistema aggiungendo il set dei percorsi allo stato dell'oggetto di autorizzazione corrente. Questo overload consente di specificare l'azione di controllo di accesso come l'accesso al Registro di sistema.

Il control parametro specifica se è possibile accedere all'elenco di controllo di accesso (ACL) per le chiavi del Registro di sistema specificate da pathList può essere modificato, visualizzato o non accessibile.

Importante

Un elenco di controllo di accesso (ACL) descrive singoli utenti o gruppi che hanno o non hanno diritti per azioni specifiche sulle chiavi del Registro di sistema specificate. La possibilità di modificare o visualizzare un ACL è un'autorizzazione importante e deve essere concessa con cautela.