MutexAcl.Create(Boolean, String, Boolean, MutexSecurity) Metode
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.
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 alur panggilan kepemilikan awal 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 layanan. 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
Objek yang mewakili mutex sistem, jika bernama, atau mutex lokal, jika tanpa nama.
Pengecualian
Hanya .NET Framework: name
lebih panjang dari MAX_PATH (260 karakter).
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.
Hanya Windows: name
menentukan namespace yang tidak dikenal. Lihat Nama Objek untuk informasi selengkapnya.
Terlalu name
panjang. Pembatasan panjang dapat bergantung pada sistem operasi atau konfigurasi.
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 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 menyinkronkan 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 layanan, WaitHandleCannotBeOpenedException
akan 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 pembatasan akses pada sistem yang mungkin memiliki pengguna yang tidak tepercaya yang menjalankan kode.