EcSaveSubscription function (evcoll.h)

Article
02/22/2024

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.

Syntax

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

Parameters

[in] Subscription

The handle to the subscription object.

[in] Flags

Reserved. Must be NULL.

Return value

This function returns BOOL.

Remarks

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.

Examples

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

Requirements

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