Mutex.TryOpenExisting Metode

Definisi

Ruang nama:

System.Threading

Rakitan:

System.Threading.dll

Membuka mutex bernama tertentu, jika sudah ada, dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.

Overload

TryOpenExisting(String, Mutex)

Membuka mutex bernama yang ditentukan, jika sudah ada, dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.

TryOpenExisting(String, Mutex)

Sumber:

Mutex.cs

Membuka mutex bernama yang ditentukan, jika sudah ada, dan mengembalikan nilai yang menunjukkan apakah operasi berhasil.

public:
 static bool TryOpenExisting(System::String ^ name, [Runtime::InteropServices::Out] System::Threading::Mutex ^ % result);

public static bool TryOpenExisting (string name, out System.Threading.Mutex? result);

static member TryOpenExisting : string * Mutex -> bool

Public Shared Function TryOpenExisting (name As String, ByRef result As Mutex) As Boolean

Parameter

name

String

Nama objek sinkronisasi yang akan dibagikan dengan proses lain. 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.

result

Mutex

Ketika metode ini kembali, berisi Mutex objek yang mewakili mutex bernama jika panggilan berhasil, atau null jika panggilan gagal. Parameter ini diperlakukan sebagai tidak diinisialisasi.

Mengembalikan

Boolean

true jika mutex bernama berhasil dibuka; jika tidak, false. Dalam beberapa kasus, false dapat dikembalikan untuk nama yang tidak valid.

Pengecualian

ArgumentException

name adalah string kosong.

-atau-

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

ArgumentNullException

nameadalah null.

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. Untuk beberapa nama yang tidak valid, metode dapat kembali false sebagai gantinya.

-atau-

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

PathTooLongException

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

UnauthorizedAccessException

Mutex bernama ada, tetapi pengguna tidak memiliki akses keamanan yang diperlukan untuk menggunakannya.

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.

Jika objek sinkronisasi dari jenis yang diminta ada di namespace layanan, objek sinkronisasi yang ada akan dibuka. Jika objek sinkronisasi tidak ada di namespace, atau objek sinkronisasi dari jenis yang berbeda ada di namespace layanan, false dikembalikan.

Untuk membuat mutex sistem ketika belum ada, gunakan salah Mutex satu konstruktor yang memiliki name parameter .

Jika Anda tidak yakin apakah mutex bernama ada, gunakan metode ini kelebihan beban alih-alih OpenExisting(String) metode kelebihan beban, yang memunculkan pengecualian jika mutex tidak ada.

Beberapa panggilan ke metode ini yang menggunakan nilai yang sama untuk name tidak selalu mengembalikan objek yang sama Mutex , meskipun objek yang dikembalikan mewakili mutex sistem bernama yang sama.

Kelebihan beban metode ini setara dengan memanggil TryOpenExisting(String, MutexRights, Mutex) metode kelebihan beban dan menentukan MutexRights.SynchronizeMutexRights.Modify hak, dikombinasikan dengan menggunakan operasi OR bitwise. Menentukan MutexRights.Synchronize bendera memungkinkan utas menunggu pada mutex, dan menentukan MutexRights.Modify bendera memungkinkan utas untuk memanggil ReleaseMutex metode .

Metode ini tidak meminta kepemilikan mutex.