API:Data.DBXPlatform.TDBXSemaphore.Create

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

constructor Create(Count: Integer);

C++

__fastcall TDBXSemaphore(int Count);

プロパティ

種類 可視性 ソース ユニット
constructor public
Data.DBXPlatform.pas
Data.DBXPlatform.hpp
Data.DBXPlatform TDBXSemaphore

説明

TSemaphore オブジェクトをインスタンス化します。

Data.DBXPlatform.TDBXSemaphore.Create は System.SyncObjs.TSemaphore.Create を継承しています。以下の内容はすべて System.SyncObjs.TSemaphore.Create を参照しています。

TSemaphore オブジェクトをインスタンス化します。

Create を呼び出すと、TSemaphore オブジェクトを作成することができます。

System.SyncObjs.TSemaphore.Create コンストラクタには、3 つのバージョンがあります。

  • 第1 コンストラクタでは、初期カウンタ値 1 で、名前のないバイナリ セマフォがを作成します。これは、デフォルト セキュリティ ディスクリプタで作成されます。
つまり、現在のプロセスの子プロセスは、このセマフォへのハンドルを継承することはできません。これは、基本的に、名前のない TMutex オブジェクトを作成するのと同じこととなります。
ヒント: UseCOMWait パラメータを設定することで、スレッドがブロックされ、オブジェクトを待機している際に、どんな STA COM 呼び出しでも、このスレッドに呼び戻すことができるようにします。
  • 第 2 コンストラクタでは、以下のパラメータ リストに示されたいくつかの属性を持つ名前付きセマフォを作成します。

Parameter

意味

SemaphoreAttributes

セマフォのセキュリティ属性。SemaphoreAttributes は、_SECURITY_ATTRIBUTES レコードへのポインタ型であり、次のフィールドがあります: nLengthlpSecurityDescriptorInheritHandlenLength フィールドは、_SECURITY_ATTRIBUTES レコードのサイズ(バイト単位)と必ず等しくなければなりません。 lpSecurityDescriptor は、セマフォのセキュリティ ディスクリプタへのポインタです。 最後の InheritHandle は、セマフォのハンドルを子プロセスに継承させる場合に True になります。

AInitialCount

セマフォ カウンタ変数の初期値で、共有リソースの未使用ユニットの初期数を示します。

AMaximumCount

セマフォ カウンタ変数の最大値で、共有リソースの使用可能ユニットの数を示します。

Name

セマフォの名前。名前は大文字/小文字が区別されます。

UseCOMWait

このパラメータを設定すると、スレッドがブロックされてオブジェクトを待っているときでも、任意の STA COM 呼び出しを逆にこのスレッドに対して行うことができます。

  • 第 3 のコンストラクタでは、名前を指定して既存のセマフォを開くことができます。 各パラメータの意味は以下のとおりです:

Parameter

意味

DesiredAccess

セマフォに対するアクセスの種類。要求した種類のアクセスが許可されなかった場合、コンストラクタは失敗します。 次の定数の任意の組み合わせにすることができます: SEMAPHORE_ALL_ACCESSSEMAPHORE_MODIFY_STATESYNCHRONIZE_DELETEREAD_CONTROLWRITE_DACWRITE_OWNER

InheritHandle

このパラメータを設定すると、子プロセスはハンドルを継承します。

Name

開くセマフォの名前。名前は大文字/小文字が区別されます。

UseCOMWait

このパラメータを設定すると、スレッドがブロックされてオブジェクトを待っているときでも、任意の STA COM 呼び出しを逆にこのスレッドに対して行うことができます。

関連項目