MutexRights Enum
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan hak kontrol akses yang dapat diterapkan ke objek mutex sistem bernama.
Enumerasi ini mendukung kombinasi bitwise dari nilai yang termasuk di dalamnya.
public enum class MutexRights[System.Flags]
public enum MutexRights[System.Flags]
[System.Security.SecurityCritical]
public enum MutexRights[<System.Flags>]
type MutexRights = [<System.Flags>]
[<System.Security.SecurityCritical>]
type MutexRights = Public Enum MutexRights- Warisan
- Atribut
Bidang
| ChangePermissions | 262144 | Hak untuk mengubah aturan keamanan dan audit yang terkait dengan mutex bernama. |
| Delete | 65536 | Hak untuk menghapus mutex bernama. |
| FullControl | 2031617 | Hak untuk mengerahkan kontrol penuh atas mutex bernama, dan untuk memodifikasi aturan akses dan aturan auditnya. |
| Modify | 1 | Hak untuk merilis mutex bernama. |
| ReadPermissions | 131072 | Hak untuk membuka dan menyalin aturan akses dan aturan audit untuk mutex bernama. |
| Synchronize | 1048576 | Hak untuk menunggu pada mutex bernama. |
| TakeOwnership | 524288 | Hak untuk mengubah pemilik mutex bernama. |
Contoh
Contoh kode berikut menunjukkan penggunaan MutexRights nilai saat membuat dan menggunakan MutexAccessRule objek. Contoh membuat MutexSecurity objek, menambahkan aturan yang mengizinkan dan menolak berbagai hak untuk pengguna saat ini, dan menampilkan pasangan aturan yang dihasilkan. Contoh kemudian memungkinkan hak baru untuk pengguna saat ini dan menampilkan hasilnya, menunjukkan bahwa hak baru digabungkan dengan aturan yang ada AccessControlType.Allow .
Catatan
Contoh ini tidak melampirkan objek keamanan ke Mutex objek; lihat MutexSecurity, Mutex.GetAccessControl metode, dan Mutex.SetAccessControl.
using System;
using System.Threading;
using System.Security.AccessControl;
using System.Security.Principal;
public class Example
{
public static void Main()
{
// Create a string representing the current user.
string user = Environment.UserDomainName + "\\" +
Environment.UserName;
// Create a security object that grants no access.
MutexSecurity mSec = new MutexSecurity();
// Add a rule that grants the current user the
// right to enter or release the mutex.
MutexAccessRule rule = new MutexAccessRule(user,
MutexRights.Synchronize | MutexRights.Modify,
AccessControlType.Allow);
mSec.AddAccessRule(rule);
// Add a rule that denies the current user the
// right to change permissions on the mutex.
rule = new MutexAccessRule(user,
MutexRights.ChangePermissions,
AccessControlType.Deny);
mSec.AddAccessRule(rule);
// Display the rules in the security object.
ShowSecurity(mSec);
// Add a rule that allows the current user the
// right to read permissions on the mutex. This rule
// is merged with the existing Allow rule.
rule = new MutexAccessRule(user,
MutexRights.ReadPermissions,
AccessControlType.Allow);
mSec.AddAccessRule(rule);
ShowSecurity(mSec);
}
private static void ShowSecurity(MutexSecurity security)
{
Console.WriteLine("\r\nCurrent access rules:\r\n");
foreach(MutexAccessRule ar in
security.GetAccessRules(true, true, typeof(NTAccount)))
{
Console.WriteLine(" User: {0}", ar.IdentityReference);
Console.WriteLine(" Type: {0}", ar.AccessControlType);
Console.WriteLine(" Rights: {0}", ar.MutexRights);
Console.WriteLine();
}
}
}
/*This code example produces output similar to following:
Current access rules:
User: TestDomain\TestUser
Type: Deny
Rights: ChangePermissions
User: TestDomain\TestUser
Type: Allow
Rights: Modify, Synchronize
Current access rules:
User: TestDomain\TestUser
Type: Deny
Rights: ChangePermissions
User: TestDomain\TestUser
Type: Allow
Rights: Modify, ReadPermissions, Synchronize
*/
Imports System.Threading
Imports System.Security.AccessControl
Imports System.Security.Principal
Public Class Example
Public Shared Sub Main()
' Create a string representing the current user.
Dim user As String = Environment.UserDomainName _
& "\" & Environment.UserName
' Create a security object that grants no access.
Dim mSec As New MutexSecurity()
' Add a rule that grants the current user the
' right to enter or release the mutex.
Dim rule As New MutexAccessRule(user, _
MutexRights.Synchronize _
Or MutexRights.Modify, _
AccessControlType.Allow)
mSec.AddAccessRule(rule)
' Add a rule that denies the current user the
' right to change permissions on the mutex.
rule = New MutexAccessRule(user, _
MutexRights.ChangePermissions, _
AccessControlType.Deny)
mSec.AddAccessRule(rule)
' Display the rules in the security object.
ShowSecurity(mSec)
' Add a rule that allows the current user the
' right to read permissions on the mutex. This rule
' is merged with the existing Allow rule.
rule = New MutexAccessRule(user, _
MutexRights.ReadPermissions, _
AccessControlType.Allow)
mSec.AddAccessRule(rule)
ShowSecurity(mSec)
End Sub
Private Shared Sub ShowSecurity(ByVal security As MutexSecurity)
Console.WriteLine(vbCrLf & "Current access rules:" & vbCrLf)
For Each ar As MutexAccessRule In _
security.GetAccessRules(True, True, GetType(NTAccount))
Console.WriteLine(" User: {0}", ar.IdentityReference)
Console.WriteLine(" Type: {0}", ar.AccessControlType)
Console.WriteLine(" Rights: {0}", ar.MutexRights)
Console.WriteLine()
Next
End Sub
End Class
'This code example produces output similar to following:
'
'Current access rules:
'
' User: TestDomain\TestUser
' Type: Deny
' Rights: ChangePermissions
'
' User: TestDomain\TestUser
' Type: Allow
' Rights: Modify, Synchronize
'
'
'Current access rules:
'
' User: TestDomain\TestUser
' Type: Deny
' Rights: ChangePermissions
'
' User: TestDomain\TestUser
' Type: Allow
' Rights: Modify, ReadPermissions, Synchronize
Keterangan
MutexRights Gunakan enumerasi untuk menentukan hak kontrol akses saat Anda membuat MutexSecurity objek. Untuk menerapkan hak akses ke mutex sistem bernama, gunakan MutexSecurity objek dengan Mutex(Boolean, String, Boolean, MutexSecurity) konstruktor dan Mutex.SetAccessControl metode .
