Поделиться через


Функция 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 Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header evcoll.h
Библиотека Wecapi.lib
DLL Wecapi.dll

См. также раздел

Функции сборщика событий Windows