EcOpenSubscription 関数 (evcoll.h)

EcOpenSubscription 関数は、既存のサブスクリプションを開くか、指定されたフラグ値に従って新しいサブスクリプションを作成するために使用されます。

構文

EC_HANDLE EcOpenSubscription(
  [in] LPCWSTR SubscriptionName,
  [in] DWORD   AccessMask,
  [in] DWORD   Flags
);

パラメーター

[in] SubscriptionName

サブスクリプションの名前です。 このパラメーターに指定する値は、コンピューターのスコープ内で一意である必要があります。

[in] AccessMask

サブスクリプションに対する必要なアクセス権を指定するアクセス マスク。 アクセス権を指定するには、 EC_READ_ACCESS または EC_WRITE_ACCESS 定数を使用します。 サブスクリプションのセキュリティ記述子が呼び出し元プロセスに対して要求されたアクセスを許可していない場合、関数は失敗します。

[in] Flags

新規または既存のサブスクリプションを開くかどうかを指定する値。 EC_CREATE_NEW、EC_OPEN_ALWAYS、またはEC_OPEN_EXISTING定数を使用します。

戻り値

関数が成功すると、新しいサブスクリプション オブジェクトへのハンドル (EC_HANDLE) が返されます。 それ以外の場合は NULL を 返します。この場合は GetLastError 関数を使用してエラー コードを取得します。

要件

こちらもご覧ください

Windows イベント コレクター関数