次の方法で共有

CreateWaitableTimerExW 関数 (synchapi.h)

  • [アーティクル]

待機可能タイマー オブジェクトを作成または開き、オブジェクトにハンドルを返します。

構文

HANDLE CreateWaitableTimerExW(
  [in, optional] LPSECURITY_ATTRIBUTES lpTimerAttributes,
  [in, optional] LPCWSTR               lpTimerName,
  [in]           DWORD                 dwFlags,
  [in]           DWORD                 dwDesiredAccess
);

パラメーター

[in, optional] lpTimerAttributes

SECURITY_ATTRIBUTES 構造体へのポインター。 このパラメーターが NULL場合、タイマー ハンドルは子プロセスによって継承できません。

lpTimerAttributes が NULL場合、タイマー オブジェクトは既定のセキュリティ記述子を取得し、ハンドルを継承できません。 タイマーの既定のセキュリティ記述子の ACL は、作成者のプライマリ トークンまたは偽装トークンから取得されます。

[in, optional] lpTimerName

タイマー オブジェクトの名前。 名前は MAX_PATH 文字に制限されています。 名前の比較では大文字と小文字が区別されます。

lpTimerName NULL場合、タイマー オブジェクトは名前なしで作成されます。

lpTimerName が既存のイベント、セマフォ、ミューテックス、ジョブ、またはファイル マッピング オブジェクトの名前と一致する場合、関数は失敗し、GetLastError は ERROR_INVALID_HANDLEを返します。 これは、これらのオブジェクトが同じ名前空間を共有しているために発生します。

名前には、グローバル名前空間またはセッション名前空間にオブジェクトを明示的に作成するための "Global" または "Local" プレフィックスを付けることができます。 名前の残りの部分には、円記号 (\) を除く任意の文字を含めることができます。 詳細については、「カーネル オブジェクト名前空間を参照してください。 高速ユーザー切り替えは、ターミナル サービス セッションを使用して実装されます。 カーネル オブジェクト名は、アプリケーションが複数のユーザーをサポートできるように、ターミナル サービスに関して概説されているガイドラインに従う必要があります。

オブジェクトはプライベート名前空間に作成できます。 詳細については、「オブジェクト名前空間の」を参照してください。

[in] dwFlags

このパラメーターには、0 または次の値を指定できます。

価値 意味
CREATE_WAITABLE_TIMER_MANUAL_RESET
0x00000001
 タイマーは手動でリセットする必要があります。 それ以外の場合、1 つの待機中のスレッドを解放した後、システムは自動的にタイマーをリセットします。
CREATE_WAITABLE_TIMER_HIGH_RESOLUTION
0x00000002
 高解像度タイマーを作成します。 この値は、数ミリ秒の順序で短い有効期限の遅延が許容できない場合に、タイム クリティカルな状況に使用します。 この値は、Windows 10 バージョン 1803 以降でサポートされています。

[in] dwDesiredAccess

タイマー オブジェクトのアクセス マスク。 アクセス権の一覧については、「同期オブジェクトのセキュリティとアクセス権のを参照してください。

戻り値

関数が成功した場合、戻り値はタイマー オブジェクトへのハンドルです。 関数呼び出しの前に名前付きタイマー オブジェクトが存在する場合、関数は既存のオブジェクトへのハンドルを返し、GetLastError は ERROR_ALREADY_EXISTSを返します。

関数が失敗した場合、戻り値は NULL。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

呼び出し元プロセスのすべてのスレッドは、のいずれかの 待機関数の呼び出しでタイマー オブジェクト ハンドルを指定できます。

複数のプロセスが同じタイマー オブジェクトへのハンドルを持つ可能性があり、プロセス間同期にオブジェクトを使用できます。

  • createWaitableTimer Ex の lpTimerAttributes パラメーターが継承を有効にしている場合、CreateProcess 関数によって作成されたプロセスは、タイマー オブジェクト ハンドルを継承できます。
  • プロセスでは、DuplicateHandle 関数の呼び出しでタイマー オブジェクト ハンドルを指定できます。 結果のハンドルは、別のプロセスで使用できます。
  • プロセスでは、OpenWaitableTimer の呼び出しまたは CreateWaitableTimerEx 関数 呼び出しでタイマー オブジェクトの名前を指定できます。

CloseHandle 関数を使用してハンドルを閉じます。 プロセスが終了すると、システムはハンドルを自動的に閉じます。 タイマー オブジェクトは、最後のハンドルが閉じられたときに破棄されます。

タイマーをウィンドウに関連付けるには、SetTimer 関数を使用します。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー synchapi.h (Windows.h を含む)
ライブラリ Kernel32.lib
DLL Kernel32.dll

関連項目

CloseHandle の

同期関数の

待機可能タイマー オブジェクト を する