EcSaveSubscription function (evcoll.h)

The EcSaveSubscription function saves subscription configuration information. This function should be called whenever new values are added or updated to the subscription by the EcSetSubscriptionProperty method. If the subscription is enabled, the subscription will be activated when it is saved.


BOOL EcSaveSubscription(
  [in] EC_HANDLE Subscription,
  [in] DWORD     Flags


[in] Subscription

The handle to the subscription object.

[in] Flags

Reserved. Must be NULL.

Return value

This function returns BOOL.


To retry a subscription for all the event sources of a subscription, use the EcSaveSubscription function instead of calling EcRetrySubscription on each event source individually.

The subscription will be active only if the collector service is running. The service must be set to automatically start and run after the computer is booted.


For example code using the EcSaveSubscription function, see Creating a Collector Initiated Subscription or Creating a Source Initiated Subscription.


Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header evcoll.h
Library Wecapi.lib
DLL Wecapi.dll

See also

Windows Event Collector Functions