Bagikan melalui


Mutex.TryOpenExisting Metode

Definisi

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, MutexRights, Mutex)

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

TryOpenExisting(String, Mutex)

Sumber:
Mutex.cs
Sumber:
Mutex.cs
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);
[System.Security.SecurityCritical]
public static bool TryOpenExisting (string name, out System.Threading.Mutex result);
public static bool TryOpenExisting (string name, out System.Threading.Mutex? result);
public static bool TryOpenExisting (string name, out System.Threading.Mutex result);
[<System.Security.SecurityCritical>]
static member TryOpenExisting : string * Mutex -> bool
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

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

Atribut

Pengecualian

name adalah string kosong.

-atau-

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

nameadalah null.

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.

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

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 ada mutex bernama, 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.

Berlaku untuk

TryOpenExisting(String, MutexRights, Mutex)

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

public:
 static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::MutexRights rights, [Runtime::InteropServices::Out] System::Threading::Mutex ^ % result);
[System.Security.SecurityCritical]
public static bool TryOpenExisting (string name, System.Security.AccessControl.MutexRights rights, out System.Threading.Mutex result);
[<System.Security.SecurityCritical>]
static member TryOpenExisting : string * System.Security.AccessControl.MutexRights * Mutex -> bool
Public Shared Function TryOpenExisting (name As String, rights As MutexRights, 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.

rights
MutexRights

Kombinasi bitwise dari nilai enumerasi yang mewakili akses keamanan yang diinginkan.

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

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

Atribut

Pengecualian

name adalah string kosong.

-atau-

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

nameadalah null.

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.

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

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 ada mutex bernama, gunakan metode ini kelebihan beban alih-alih OpenExisting(String, MutexRights) metode kelebihan beban, yang memunculkan pengecualian jika mutex tidak ada.

Parameter rights harus menyertakan MutexRights.Synchronize bendera untuk memungkinkan utas menunggu pada mutex, dan MutexRights.Modify bendera untuk memungkinkan utas memanggil ReleaseMutex metode .

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.

Metode ini tidak meminta kepemilikan mutex.

Berlaku untuk