MutexAcl.Create(Boolean, String, Boolean, MutexSecurity) Metode

Definisi

Ruang nama:

System.Threading

Rakitan:

System.Threading.AccessControl.dll

Paket:

System.Threading.AccessControl v9.0.0-preview.3.24172.9

Sumber:

MutexAcl.cs

Mendapatkan atau membuat instans Mutex , memungkinkan MutexSecurity ditentukan secara opsional untuk mengaturnya selama pembuatan mutex.

public:
 static System::Threading::Mutex ^ Create(bool initiallyOwned, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew, System::Security::AccessControl::MutexSecurity ^ mutexSecurity);

public static System.Threading.Mutex Create (bool initiallyOwned, string? name, out bool createdNew, System.Security.AccessControl.MutexSecurity? mutexSecurity);

static member Create : bool * string * bool * System.Security.AccessControl.MutexSecurity -> System.Threading.Mutex

Public Shared Function Create (initiallyOwned As Boolean, name As String, ByRef createdNew As Boolean, mutexSecurity As MutexSecurity) As Mutex

Parameter

initiallyOwned

Boolean

true untuk memberikan kepemilikan awal utas panggilan dari mutex sistem bernama jika mutex sistem bernama dibuat sebagai akibat dari panggilan ini; jika tidak, false.

name

String

Nama, jika objek sinkronisasi akan dibagikan dengan proses lain; jika tidak, null atau string kosong. Namanya peka huruf besar/kecil. Karakter garis miring terbalik (\) dicadangkan dan hanya dapat digunakan untuk menentukan namespace. Untuk informasi selengkapnya tentang namespace layanan, lihat bagian keterangan. Mungkin ada pembatasan lebih lanjut pada nama tergantung pada sistem operasi. Misalnya, pada sistem operasi berbasis Unix, nama setelah mengecualikan namespace harus berupa nama file yang valid.

createdNew

Boolean

Ketika metode ini kembali, argumen ini selalu diatur ke true jika mutex lokal dibuat; yaitu, kapan name adalah null atau Empty. Jika name memiliki nilai tidak kosong yang valid, argumen ini diatur ke true ketika mutex sistem dibuat, atau diatur ke false jika mutex sistem yang ada ditemukan dengan nama tersebut. Parameter ini diteruskan tanpa diinisialisasi.

mutexSecurity

MutexSecurity

Keamanan kontrol akses mutex opsional untuk diterapkan.

Mengembalikan

Mutex

Objek yang mewakili mutex sistem, jika bernama, atau mutex lokal, jika tanpa nama.

Pengecualian

ArgumentException

.NET Framework saja: name lebih panjang dari MAX_PATH (260 karakter).

IOException

name tidak valid. Ini bisa karena berbagai alasan, termasuk beberapa batasan yang mungkin ditempatkan oleh sistem operasi, seperti awalan yang tidak diketahui atau karakter yang tidak valid. Perhatikan bahwa nama dan awalan umum "Global\" dan "Local\" peka huruf besar/kecil.

-atau-

Ada beberapa kesalahan lainnya. Properti HResult dapat memberikan informasi lebih lanjut.

DirectoryNotFoundException

Hanya Windows: name menentukan namespace yang tidak dikenal. Lihat Nama Objek untuk informasi selengkapnya.

PathTooLongException

Terlalu name panjang. Pembatasan panjang dapat bergantung pada sistem operasi atau konfigurasi.

WaitHandleCannotBeOpenedException

Objek sinkronisasi dengan yang disediakan name tidak dapat dibuat. Objek sinkronisasi dari jenis yang berbeda mungkin memiliki nama yang sama.

Keterangan

name mungkin diawali dengan Global\ atau Local\ untuk menentukan namespace. Global Ketika namespace ditentukan, objek sinkronisasi dapat dibagikan dengan proses apa pun pada sistem. Local Ketika namespace layanan ditentukan, yang juga merupakan default ketika tidak ada namespace yang ditentukan, objek sinkronisasi dapat dibagikan dengan proses dalam sesi yang sama. Di Windows, sesi adalah sesi masuk, dan layanan biasanya berjalan dalam sesi non-interaktif yang berbeda. Pada sistem operasi seperti Unix, setiap shell memiliki sesinya sendiri. Objek sinkronisasi sesi-lokal mungkin sesuai untuk disinkronkan antara proses dengan hubungan induk/anak di mana semuanya berjalan dalam sesi yang sama. Untuk informasi selengkapnya tentang nama objek sinkronisasi di Windows, lihat Nama Objek.

name Jika disediakan dan objek sinkronisasi dari jenis yang diminta sudah ada di namespace layanan, objek sinkronisasi yang ada akan dibuka. Jika objek sinkronisasi dari jenis yang berbeda sudah ada di namespace, akan WaitHandleCannotBeOpenedException dilemparkan. Jika tidak, objek sinkronisasi baru dibuat.

Perhatian

Secara default, mutex bernama tidak dibatasi untuk pengguna yang membuatnya. Pengguna lain mungkin dapat membuka dan menggunakan mutex, termasuk mengganggu mutex dengan memasukkan mutex dan tidak keluar darinya. Untuk membatasi akses ke pengguna tertentu, Anda dapat meneruskan MutexSecurity saat membuat mutex bernama. Hindari menggunakan mutex bernama tanpa batasan akses pada sistem yang mungkin memiliki pengguna yang tidak tepercaya yang menjalankan kode.