SemaphoreAcl.Create(Int32, Int32, String, Boolean, SemaphoreSecurity) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Semaphore インスタンスを取得または作成します。これにより、SemaphoreSecurity インスタンスをイベントの作成時に設定するように必要に応じて指定できます。
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.SemaphorePublic Shared Function Create (initialCount As Integer, maximumCount As Integer, name As String, ByRef createdNew As Boolean, semaphoreSecurity As SemaphoreSecurity) As Semaphoreパラメーター
- initialCount
- Int32
同時に満たすことができるセマフォの要求の初期数。
- maximumCount
- Int32
同時に満たすことができるセマフォの要求の最大数。
- name
- String
同期オブジェクトを他のプロセスと共有する場合の名前。それ以外の場合は、 null または空の文字列。 名前では大文字と小文字が区別されます。 円記号 (\) は予約されており、名前空間の指定にのみ使用できます。 名前空間の詳細については、「解説」セクションを参照してください。 オペレーティング システムによっては、名前にさらに制限がある場合があります。 たとえば、Unix ベースのオペレーティング システムでは、名前空間を除外した後の名前は有効なファイル名である必要があります。
- createdNew
- Boolean
このメソッドが戻るときに、ローカル セマフォが作成された場合、つまり、nameがnullまたはEmptyの場合、この引数は常にtrueに設定されます。
nameに有効な空でない値がある場合、この引数はシステム セマフォの作成時にtrueに設定されます。または、既存のシステム セマフォがその名前で見つかった場合はfalseに設定されます。 このパラメーターは初期化せずに渡されます。
- semaphoreSecurity
- SemaphoreSecurity
適用するオプションのセマフォ アクセス制御セキュリティ。
返品
名前付きの場合はシステム セマフォを表すオブジェクト。名前のない場合はローカル セマフォ。
例外
initialCount が maximumCount より大きい。
-又は-
.NET Framework のみ: name がMAX_PATH (260 文字) より長くなっています。
name が無効です。 これは、不明なプレフィックスや無効な文字など、オペレーティング システムによって適用される可能性のあるいくつかの制限など、さまざまな理由が考えられます。 名前と共通プレフィックス "Global\" と "Local\" では大文字と小文字が区別されることに注意してください。
-又は-
その他のエラーが発生しました。
HResultプロパティは、詳細情報を提供する場合があります。
Windowsのみ: nameが不明な名前空間を指定しました。 詳細については、「 オブジェクト名」 を参照してください。
name は長すぎます。 長さの制限は、オペレーティング システムまたは構成によって異なります。
指定された name を持つ同期オブジェクトを作成できません。 異なる種類の同期オブジェクトの名前が同じである可能性があります。
注釈
nameには、名前空間を指定するために、Global\またはLocal\のプレフィックスを付ける場合があります。
Global名前空間を指定すると、同期オブジェクトをシステム上の任意のプロセスと共有できます。
Local名前空間が指定されている場合(名前空間が指定されていない場合の既定値)、同期オブジェクトを同じセッション内のプロセスと共有できます。 Windowsでは、セッションはログイン セッションであり、サービスは通常、別の非対話型セッションで実行されます。 Unix に似たオペレーティング システムでは、各シェルに独自のセッションがあります。 セッションとローカルの同期オブジェクトは、プロセス間の同期に適している場合があります。このオブジェクトはすべて同じセッションで実行されます。 Windowsの同期オブジェクト名の詳細については、「Object Names」を参照してください。
nameが指定されていて、要求された型の同期オブジェクトが名前空間に既に存在する場合は、既存の同期オブジェクトが開かれます。 別の型の同期オブジェクトが既に名前空間に存在する場合は、 WaitHandleCannotBeOpenedException がスローされます。 それ以外の場合は、新しい同期オブジェクトが作成されます。
Caution
既定では、名前付きセマフォは、それを作成したユーザーに制限されません。 セマフォを複数回取得して解放しないことでセマフォを妨害するなど、他のユーザーがセマフォを開いて使用できる場合があります。 特定のユーザーへのアクセスを制限するために、名前付きセマフォの作成時に SemaphoreSecurity を渡すことができます。 信頼されていないユーザーがコードを実行している可能性があるシステムでは、アクセス制限なしで名前付きセマフォを使用しないでください。
