名前付きまたは名前なしのイベントオブジェクトを作成または開きます。
#Include <WinAPI.au3>
_WinAPI_CreateEvent([$pAttributes = 0 [, $fManualReset = True [, $fInitialState = True [, $sName = ""]]]])
パラメータ
| $pAttributes | [オプション]$tagSECURITY_ATTRIBUTES構造体へのポインタ。 0の場合、ハンドルは子プロセスに継承できません。 構造体のDescriptorメンバーは新しいイベントのセキュリティ記述子を指定します。 pAttributesが0の場合、イベントはデフォルトのセキュリティ記述子を取得します。 イベント用のデフォルトセキュリティ記述子のACLは作成者のプライマリトークンまたは偽装トークンによります。 |
| $fManualReset | [オプション]Trueの場合、この関数はイベント状態を非シグナル状態に設定するためにResetEvent関数の使用が必要な手動リセットイベントオブジェクトを作成します。 Falseの場合、この関数は自動リセットイベントを作成し、システムは1つの待機スレッドが解放された後に自動でイベント状態を非シグナル状態にリセットします。 |
| $fInitialState | [オプション]Trueの場合はイベントオブジェクトの初期状態がシグナル状態になり、それ以外の場合は非シグナル状態になります。 |
| $sName | [オプション]イベントオブジェクトの名前。名前の比較では大文字と小文字が区別されます。 sNameが既存の名前付きイベントオブジェクトと一致した場合、この関数はEVENT_ALL_ACCESSアクセス権限を要求します。 この場合、fManualResetパラメータとfInitialStateパラメータは既に作成プロセスによって設定されているため無視されます。 pAttributesパラメータがゼロでない場合、ハンドルは継承可能になりますがそのセキュリティ記述子メンバーは無視されます。 名前が空白の場合、イベントオブジェクトは名前なしで作成されます。 |
返し値
| 成功: | イベントオブジェクトのハンドル |
| 名前付きイベントオブジェクトが関数呼び出し前に既に存在する場合、関数は既存のオブジェクトのハンドルを返し、GetLastErrorはERROR_ALREADY_EXISTSを返します。 | |
| 失敗: | 0 |
注意
なし。
関連
$tagSECURITY_ATTRIBUTES
こちらも参照
MSDNライブラリでCreateEventを検索して下さい。