SemaphoreAcl.Create(Int32, Int32, String, Boolean, SemaphoreSecurity) Metoda

Definicja

Przestrzeń nazw:

System.Threading

Zestaw:

System.Threading.AccessControl.dll

Pakiet:

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

Źródło:

SemaphoreAcl.cs

Pobiera lub tworzy Semaphore wystąpienie, umożliwiając SemaphoreSecurity opcjonalne określenie wystąpienia w celu ustawienia go podczas tworzenia zdarzenia.

public:
 static System::Threading::Semaphore ^ Create(int initialCount, int maximumCount, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew, System::Security::AccessControl::SemaphoreSecurity ^ semaphoreSecurity);

public static System.Threading.Semaphore Create (int initialCount, int maximumCount, string? name, out bool createdNew, System.Security.AccessControl.SemaphoreSecurity? semaphoreSecurity);

static member Create : int * int * string * bool * System.Security.AccessControl.SemaphoreSecurity -> System.Threading.Semaphore

Public Shared Function Create (initialCount As Integer, maximumCount As Integer, name As String, ByRef createdNew As Boolean, semaphoreSecurity As SemaphoreSecurity) As Semaphore

Parametry

initialCount

Int32

Początkowa liczba żądań semafora, które mogą być spełnione jednocześnie.

maximumCount

Int32

Maksymalna liczba żądań semafora, które mogą być spełnione jednocześnie.

name

String

Nazwa, jeśli obiekt synchronizacji ma być współużytkowany z innymi procesami; null w przeciwnym razie lub pusty ciąg. W nazwie jest rozróżniana wielkość liter. Znak ukośnika odwrotnego (\) jest zarezerwowany i może służyć tylko do określania przestrzeni nazw. Aby uzyskać więcej informacji na temat przestrzeni nazw, zobacz sekcję uwagi. W zależności od systemu operacyjnego mogą istnieć dalsze ograniczenia dotyczące nazwy. Na przykład w systemach operacyjnych opartych na systemie Unix nazwa po wykluczeniu przestrzeni nazw musi być prawidłową nazwą pliku.

createdNew

Boolean

Gdy ta metoda zostanie zwrócona, ten argument jest zawsze ustawiany na true wartość , jeśli zostanie utworzony semafor lokalny, czyli wtedy, gdy name jest null lub Empty. Jeśli name ma prawidłową, niepustą wartość, ten argument jest ustawiony na true wartość po utworzeniu semafora systemowego lub jest ustawiony, false jeśli istniejący semafor systemowy zostanie znaleziony z tą nazwą. Ten parametr jest przekazywany jako niezainicjowany.

semaphoreSecurity

SemaphoreSecurity

Opcjonalne zabezpieczenia kontroli dostępu semafora do zastosowania.

Zwraca

Semaphore

Obiekt reprezentujący semafor systemowy, jeśli nazwany lub lokalny semafor, jeśli bez nazwy.

Wyjątki

ArgumentOutOfRangeException

initialCount jest liczbą ujemną. -lub-

maximumCount nie jest liczbą dodatnią.

ArgumentException

initialCount wartość jest większa niż maximumCount.

-lub-

tylko .NET Framework: name jest dłuższy niż MAX_PATH (260 znaków).

IOException

Nazwa name jest niepoprawna. Może to być z różnych powodów, w tym niektóre ograniczenia, które mogą zostać wprowadzone przez system operacyjny, takie jak nieznany prefiks lub nieprawidłowe znaki. Należy pamiętać, że nazwy i typowe prefiksy "Global\" i "Local\" są uwzględniane wielkość liter.

-lub-

Wystąpił inny błąd. Właściwość HResult może dostarczyć więcej informacji.

DirectoryNotFoundException

Tylko system Windows: name określono nieznaną przestrzeń nazw. Aby uzyskać więcej informacji, zobacz Nazwy obiektów .

PathTooLongException

Jest name za długi. Ograniczenia długości mogą zależeć od systemu operacyjnego lub konfiguracji.

WaitHandleCannotBeOpenedException

Nie można utworzyć obiektu synchronizacji z podanym name . Obiekt synchronizacji innego typu może mieć taką samą nazwę.

Uwagi

Element name może być poprzedzony prefiksem Global\ lub Local\ w celu określenia przestrzeni nazw. Po określeniu Global przestrzeni nazw obiekt synchronizacji może być współużytkowany z dowolnymi procesami w systemie. Po określeniu Local przestrzeni nazw, która jest również domyślna, gdy nie określono przestrzeni nazw, obiekt synchronizacji może być współużytkowany z procesami w tej samej sesji. W systemie Windows sesja jest sesją logowania, a usługi są zwykle uruchamiane w innej sesji nieinterakcyjnej. W systemach operacyjnych podobnych do systemu Unix każda powłoka ma własną sesję. Obiekty synchronizacji lokalnej sesji mogą być odpowiednie do synchronizowania procesów z relacją nadrzędną/podrzędną, w której wszystkie są uruchamiane w tej samej sesji. Aby uzyskać więcej informacji na temat nazw obiektów synchronizacji w systemie Windows, zobacz Nazwy obiektów.

name Jeśli element jest podany, a obiekt synchronizacji żądanego typu już istnieje w przestrzeni nazw, istniejący obiekt synchronizacji jest otwarty. Jeśli obiekt synchronizacji innego typu już istnieje w przestrzeni nazw, WaitHandleCannotBeOpenedException jest zgłaszany. W przeciwnym razie zostanie utworzony nowy obiekt synchronizacji.

Przestroga

Domyślnie nazwany semafor nie jest ograniczony do użytkownika, który go utworzył. Inni użytkownicy mogą być w stanie otworzyć i użyć semaforu, w tym zakłócać semafor przez uzyskanie semafora wiele razy i nie zwalniając go. Aby ograniczyć dostęp do określonych użytkowników, możesz przekazać SemaphoreSecurity element podczas tworzenia nazwanego semafora. Unikaj używania nazwanych semaphores bez ograniczeń dostępu w systemach, które mogą mieć niezaufanych użytkowników z uruchomionym kodem.