EvtClose 関数 (winevt.h)

開いているハンドルを閉じます。

構文

BOOL EvtClose(
  [in] EVT_HANDLE Object
);

パラメーター

[in] Object

閉じる開いているイベント ハンドル。

戻り値

リターン コード/値	説明
TRUE	関数は成功しました
FALSE	関数が失敗しました。 エラー コードを取得するには、 GetLastError 関数を呼び出します。

解説

ハンドルを閉じた後は、ハンドルを使用できません。 親ハンドルを閉じると、ハンドルを使用して作成された開いているハンドルも閉じられます。 たとえば、イベントを照会する場合、クエリ結果には、クエリに一致する各イベントのハンドルが含まれます。 ベスト プラクティスでは、イベントが完了したときに各イベント ハンドルを閉じ、閉じていない場合は、クエリ ハンドルを閉じると、すべてのイベント ハンドルも閉じられることをお勧めします。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winevt.h
Library	Wevtapi.lib
[DLL]	Wevtapi.dll