celix_service_use_options Struct Reference

#include <celix_bundle_context.h>

Collaboration diagram for celix_service_use_options:

Public Attributes
celix_service_filter_options_t filter	OPTS_INIT
double waitTimeoutInSeconds	OPTS_INIT
void *callbackHandle	OPTS_INIT
void(*	use )(void *handle, void *svc) OPTS_INIT
void(*	useWithProperties )(void *handle, void *svc, const celix_properties_t *props) OPTS_INIT
void(*	useWithOwner )(void *handle, void *svc, const celix_properties_t *props, const celix_bundle_t *svcOwner) OPTS_INIT

Detailed Description

Service Use Options used to fine tune which services to use and which callbacks to use.

Member Data Documentation

celix_service_filter_options_t filter celix_service_use_options::OPTS_INIT

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

double waitTimeoutInSeconds celix_service_use_options::OPTS_INIT

An optional timeout (in seconds), if > 0 the use service call will block untill the timeout is expired or when at least one service is found. Default (0)

void* callbackHandle celix_service_use_options::OPTS_INIT

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

void(* celix_service_use_options::use) (void *handle, void *svc) OPTS_INIT

The optional use callback will be called when for every services found conform the service filter options

• in case of findServices - or only for the highest ranking service found - in case of findService -.

Parameters

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

void(* celix_service_use_options::useWithOwner) (void *handle, void *svc, const celix_properties_t *props, const celix_bundle_t *svcOwner) OPTS_INIT

The optional useWithOwner callback is handled as the yse 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_use_options::useWithProperties) (void *handle, void *svc, const celix_properties_t *props) OPTS_INIT

The optional useWithProperties callback is handled as the use 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