celix_service_tracking_options Struct Reference

#include <celix_bundle_context.h>

Collaboration diagram for celix_service_tracking_options:

Public Attributes
celix_service_filter_options_t filter	OPTS_INIT
void *callbackHandle	OPTS_INIT
void(*	set )(void *handle, void *svc) OPTS_INIT
void(*	setWithProperties )(void *handle, void *svc, const celix_properties_t *props) OPTS_INIT
void(*	setWithOwner )(void *handle, void *svc, const celix_properties_t *props, const celix_bundle_t *svcOwner) OPTS_INIT
void(*	add )(void *handle, void *svc) OPTS_INIT
void(*	addWithProperties )(void *handle, void *svc, const celix_properties_t *props) OPTS_INIT
void(*	addWithOwner )(void *handle, void *svc, const celix_properties_t *props, const celix_bundle_t *svcOwner) OPTS_INIT
void(*	remove )(void *handle, void *svc) OPTS_INIT
void(*	removeWithProperties )(void *handle, void *svc, const celix_properties_t *props) OPTS_INIT
void(*	removeWithOwner )(void *handle, void *svc, const celix_properties_t *props, const celix_bundle_t *svcOwner) OPTS_INIT

Detailed Description

Service Tracker Options used to fine tune which services to track and the callback to be used for the tracked services.

Member Data Documentation

void(* celix_service_tracking_options::add) (void *handle, void *svc) OPTS_INIT

The optional add callback will be called for every current and future service found conform the provided service filter options as long as the tracker is active.

Parameters

handle	The callbackHandle pointer as provided in the service tracker options.
svc	The service pointer of a service matching the provided service filter options.

void(* celix_service_tracking_options::addWithOwner) (void *handle, void *svc, const celix_properties_t *props, const celix_bundle_t *svcOwner) OPTS_INIT

The optional addWithOwner callback is handled as the add callback, but with the addition that the service properties and the bundle owning the service will also be provided to the callback.

void(* celix_service_tracking_options::addWithProperties) (void *handle, void *svc, const celix_properties_t *props) OPTS_INIT

The optional addWithProperties callback is handled as the add callback, but with the addition that the service properties will also be provided to the callback.

celix_service_filter_options_t filter celix_service_tracking_options::OPTS_INIT

The service filter options, used to setup the filter for the service to track.

void* callbackHandle celix_service_tracking_options::OPTS_INIT

The optional callback pointer used in all the provided callback function (set, add, remove, setWithProperties, etc).

void(* celix_service_tracking_options::remove) (void *handle, void *svc) OPTS_INIT

The optional remove callback will be called for every service conform the provided service filter options that is unregistered. When the remove call is finished the removed services should be considered invalid. This means that the callback provider should ensure that the removed service is not in use or going to be used after the remove callback is finished.

Parameters

handle	The callbackHandle pointer as provided in the service tracker options.
svc	The service pointer of a service matching the provided service filter options.

void(* celix_service_tracking_options::removeWithOwner) (void *handle, void *svc, const celix_properties_t *props, const celix_bundle_t *svcOwner) OPTS_INIT

The optional removeWithOwner callback is handled as the remove callback, but with the addition that the service properties and the bundle owning the service will also be provided to the callback.

void(* celix_service_tracking_options::removeWithProperties) (void *handle, void *svc, const celix_properties_t *props) OPTS_INIT

The optional removeWithProperties callback is handled as the remove callback, but with the addition that the service properties will also be provided to the callback.

void(* celix_service_tracking_options::set) (void *handle, void *svc) OPTS_INIT

The optional set callback will be called when a new highest ranking service is available conform the provided service filter options.

Parameters

handle	The callbackHandle pointer as provided in the service tracker options.
svc	The service pointer of the highest ranking service.

void(* celix_service_tracking_options::setWithOwner) (void *handle, void *svc, const celix_properties_t *props, const celix_bundle_t *svcOwner) OPTS_INIT

The optional setWithOwner callback is handled as the set callback, but with the addition that the service properties and the bundle owning the service will also be provided to the callback.

void(* celix_service_tracking_options::setWithProperties) (void *handle, void *svc, const celix_properties_t *props) OPTS_INIT

The optional setWithProperties callback is handled as the set callback, but with the addition that the service properties will also be provided to the callback.

---

The documentation for this struct was generated from the following file:

• libs/framework/include/celix_bundle_context.h