EventWaitHandle.TryOpenExisting Yöntem

Tanım

Ad Alanı:: System.Threading

Bütünleştirilmiş Kodlar:: mscorlib.dll, System.Threading.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Threading.dll

Bütünleştirilmiş Kod:: System.Threading.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Zaten varsa belirtilen adlandırılmış bir eşitleme olayını açar ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.

Aşırı Yüklemeler

Name	Description
TryOpenExisting(String, EventWaitHandle)	Belirtilen adlandırılmış eşitleme olayını (zaten varsa) açar ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.
TryOpenExisting(String, EventWaitHandleRights, EventWaitHandle)	Belirtilen adlandırılmış eşitleme olayını ( zaten varsa) istenen güvenlik erişimiyle açar ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.
TryOpenExisting(String, NamedWaitHandleOptions, EventWaitHandle)	Belirtilen adlandırılmış eşitleme olayını (zaten varsa) açar ve işlemin başarılı olup olmadığını gösteren bir değer döndürür. Seçenekler yalnızca geçerli kullanıcıya ayarlanırsa, nesnenin erişim denetimleri çağıran kullanıcı için doğrulanır.

TryOpenExisting(String, EventWaitHandle)

Kaynak:: EventWaitHandle.cs

Kaynak:: EventWaitHandle.cs

Kaynak:: EventWaitHandle.cs

Kaynak:: EventWaitHandle.cs

Kaynak:: EventWaitHandle.cs

Belirtilen adlandırılmış eşitleme olayını (zaten varsa) açar ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.

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

[System.Security.SecurityCritical]
public static bool TryOpenExisting(string name, out System.Threading.EventWaitHandle result);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static bool TryOpenExisting(string name, out System.Threading.EventWaitHandle? result);

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

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

[<System.Security.SecurityCritical>]
static member TryOpenExisting : string * EventWaitHandle -> bool

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member TryOpenExisting : string * EventWaitHandle -> bool

static member TryOpenExisting : string * EventWaitHandle -> bool

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

Parametreler

name: String

Açılacak ve diğer işlemlerle paylaşılacak eşitleme nesnesinin adı. Ad büyük/küçük harfe duyarlıdır. Ters eğik çizgi karakteri (\) ayrılmıştır ve yalnızca bir ad alanı belirtmek için kullanılabilir. Ad alanları hakkında daha fazla bilgi için açıklamalar bölümüne bakın. İşletim sistemine bağlı olarak ad üzerinde başka kısıtlamalar da olabilir. Örneğin, Unix tabanlı işletim sistemlerinde, ad alanı dışlanmadan sonraki ad geçerli bir dosya adı olmalıdır.

result: EventWaitHandle

Bu yöntem döndürdüğünde, çağrı başarılı olursa veya EventWaitHandle çağrı başarısız olursa adlandırılmış eşitleme olayını temsil eden bir null nesne içerir. Bu parametre başlatılmamış olarak değerlendirilir.

Döndürülenler

Boolean

true adlandırılmış eşitleme olayı başarıyla açıldıysa; aksi takdirde , false. Bazı durumlarda, false geçersiz adlar için döndürülebilir.

Öznitelikler: SecurityCriticalAttribute SupportedOSPlatformAttribute

Özel durumlar

ArgumentException

name boş bir dizedir.

-veya-

Yalnızca .NET Framework: name MAX_PATH'den (260 karakter) uzundur.

ArgumentNullException

name, null'e eşittir.

IOException

name geçersiz. Bu, bilinmeyen ön ek veya geçersiz karakterler gibi işletim sistemi tarafından yerleştirilebilen bazı kısıtlamalar da dahil olmak üzere çeşitli nedenlerle olabilir. Adın ve "Genel\" ve "Yerel\" ortak ön eklerinin büyük/küçük harfe duyarlı olduğunu unutmayın. Bazı geçersiz adlar için bunun yerine yöntemi döndürülebilir false .

-veya-

Başka bir hata oluştu. HResult özelliği daha fazla bilgi sağlayabilir.

PathTooLongException

name çok uzun. Uzunluk kısıtlamaları işletim sistemine veya yapılandırmaya bağlı olabilir.

UnauthorizedAccessException

Adlandırılmış olay var, ancak kullanıcı istenen güvenlik erişimine sahip değil.

Açıklamalar

name bir ad alanı belirtmek için veya Global\ ön eki Local\ eklenebilir. Ad alanı belirtildiğinde Global , eşitleme nesnesi sistemdeki tüm işlemlerle paylaşılabilir. Local Ad alanı belirtilmediğinde de varsayılan olan ad alanı belirtildiğinde, eşitleme nesnesi aynı oturumdaki işlemlerle paylaşılabilir. Windows oturum, oturum açma oturumudur ve hizmetler genellikle etkileşimli olmayan farklı bir oturumda çalışır. Unix benzeri işletim sistemlerinde her kabuğun kendi oturumu vardır. Oturum yerel eşitleme nesneleri, tümü aynı oturumda çalıştırıldığı bir üst/alt ilişki ile işlemler arasında eşitleme için uygun olabilir. Windows eşitleme nesnesi adları hakkında daha fazla bilgi için bkz. Object Names.

İstenen türde bir eşitleme nesnesi ad alanında varsa, var olan eşitleme nesnesi açılır. Ad alanında bir eşitleme nesnesi yoksa veya ad alanında farklı türde bir eşitleme nesnesi varsa, false döndürülür.

Henüz mevcut olmadığında sistem olayını oluşturmak için parametresi olan EventWaitHandle oluşturuculardan name birini kullanın.

Adlandırılmış eşitleme olayının mevcut olup olmadığından emin değilseniz, eşitleme olayı yoksa bir özel durum oluşturan yöntem aşırı yüklemesi yerine OpenExisting(String) bu yöntem aşırı yüklemesini kullanın.

Bu yöntem aşırı yüklemesi, yöntem aşırı yüklemesini TryOpenExisting(String, EventWaitHandleRights, EventWaitHandle) çağırmaya ve bit düzeyinde OR işlemi kullanılarak birleştirilen ve EventWaitHandleRights.Synchronize hakları belirtmeye EventWaitHandleRights.Modify eşdeğerdir. bayrağının EventWaitHandleRights.Synchronize belirtilmesi, bir iş parçacığının adlandırılmış sistem olayında beklemesine ve bayrağının belirtilmesi bir iş parçacığının EventWaitHandleRights.Modify ve Set yöntemlerini çağırmasına Reset olanak tanır.

Döndürülen nesneler aynı name adlandırılmış sistem olayını temsil etse bile, için aynı değeri EventWaitHandle kullanan bu yönteme yapılan birden çok çağrı mutlaka aynı nesneyi döndürmez.

Şunlara uygulanır

TryOpenExisting(String, EventWaitHandleRights, EventWaitHandle)

Belirtilen adlandırılmış eşitleme olayını ( zaten varsa) istenen güvenlik erişimiyle açar ve işlemin başarılı olup olmadığını gösteren bir değer döndürür.

public:
 static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::EventWaitHandleRights rights, [Runtime::InteropServices::Out] System::Threading::EventWaitHandle ^ % result);

[System.Security.SecurityCritical]
public static bool TryOpenExisting(string name, System.Security.AccessControl.EventWaitHandleRights rights, out System.Threading.EventWaitHandle result);

[<System.Security.SecurityCritical>]
static member TryOpenExisting : string * System.Security.AccessControl.EventWaitHandleRights * EventWaitHandle -> bool

Public Shared Function TryOpenExisting (name As String, rights As EventWaitHandleRights, ByRef result As EventWaitHandle) As Boolean

Parametreler

name: String

rights: EventWaitHandleRights

İstenen güvenlik erişimini temsil eden numaralandırma değerlerinin bit düzeyinde birleşimi.

result: EventWaitHandle

Döndürülenler

Boolean

true adlandırılmış eşitleme olayı başarıyla açıldıysa; aksi takdirde , false. Bazı durumlarda, false geçersiz adlar için döndürülebilir.

Öznitelikler: SecurityCriticalAttribute

Özel durumlar

ArgumentException

name boş bir dizedir.

-veya-

Yalnızca .NET Framework: name MAX_PATH'den (260 karakter) uzundur.

ArgumentNullException

name, null'e eşittir.

IOException

-veya-

Başka bir hata oluştu. HResult özelliği daha fazla bilgi sağlayabilir.

PathTooLongException

name çok uzun. Uzunluk kısıtlamaları işletim sistemine veya yapılandırmaya bağlı olabilir.

UnauthorizedAccessException

Adlandırılmış olay var, ancak kullanıcı istenen güvenlik erişimine sahip değil.

Açıklamalar

Henüz mevcut olmadığında sistem olayını oluşturmak için parametresi olan EventWaitHandle oluşturuculardan name birini kullanın.

parametresi, rights iş parçacıklarının EventWaitHandleRights.Synchronize olayda beklemesine izin vermek için bayrağını ve iş parçacıklarının EventWaitHandleRights.Modify ve Set yöntemlerini çağırmasına izin vermek için bayrağını Reset içermelidir.

Şunlara uygulanır

TryOpenExisting(String, NamedWaitHandleOptions, EventWaitHandle)

Kaynak:: EventWaitHandle.cs

Kaynak:: EventWaitHandle.cs

Belirtilen adlandırılmış eşitleme olayını (zaten varsa) açar ve işlemin başarılı olup olmadığını gösteren bir değer döndürür. Seçenekler yalnızca geçerli kullanıcıya ayarlanırsa, nesnenin erişim denetimleri çağıran kullanıcı için doğrulanır.

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static bool TryOpenExisting(string name, System.Threading.NamedWaitHandleOptions options, out System.Threading.EventWaitHandle? result);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member TryOpenExisting : string * System.Threading.NamedWaitHandleOptions * EventWaitHandle -> bool

Public Shared Function TryOpenExisting (name As String, options As NamedWaitHandleOptions, ByRef result As EventWaitHandle) As Boolean

Parametreler

name: String

Açılacak ve diğer işlemlerle paylaşılacak eşitleme nesnesinin adı. Ad büyük/küçük harfe duyarlıdır.

options: NamedWaitHandleOptions

Adlandırılmış tanıtıcı için kapsam seçenekleri. Varsayılan erişim yalnızca geçerli kullanıcı ve geçerli oturum ile sınırlıdır. Belirtilen seçenekler, adın ad alanını ve temel alınan tanıtıcı nesnesine erişimi etkileyebilir.

result: EventWaitHandle

Döndürülenler

Boolean

true adlandırılmış eşitleme olayı başarıyla açıldıysa; aksi takdirde , false. Bazı durumlarda, false geçersiz adlar için döndürülebilir.

Öznitelikler: SupportedOSPlatformAttribute

Özel durumlar

ArgumentException

name boş bir dizedir.

ArgumentNullException

name, null'e eşittir.

IOException

-veya-

Başka bir hata oluştu. HResult özelliği daha fazla bilgi sağlayabilir.

PathTooLongException

name çok uzun. Uzunluk kısıtlamaları işletim sistemine veya yapılandırmaya bağlı olabilir.

UnauthorizedAccessException

Adlandırılmış olay var, ancak kullanıcı istenen güvenlik erişimine sahip değil.

Açıklamalar

İstenen türde bir eşitleme nesnesi ad alanında varsa, var olan eşitleme nesnesi açılır. Ancak, geçerli kullanıcıyla sınırlı erişimi belirtirse options ve eşitleme nesnesi onunla uyumlu değilse, false döndürülür. Ad alanında bir eşitleme nesnesi yoksa veya ad alanında farklı türde bir eşitleme nesnesi varsa, false da döndürülür.

Henüz mevcut olmadığında sistem olayını oluşturmak için parametresi olan EventWaitHandle oluşturuculardan name birini kullanın.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?