test

Sun Java Communications Suite 5 Event Notification Service Guide

subscribe_a

Purpose

Establishes an asynchronous subscription.

Syntax

void subscribe_a (subscriber_t *subscriber,
                  const char *event_ref,
                  subscriber_notify_cb_t notify_cb,
                  void *notify_arg,
                  subscriber_cb_t cbdone,
                  void *cbarg):

Parameters

subscriber

The subscriber. 

event_ref

The event reference. This is a URI identifying the event’s source. 

notify_cb

The callback invoked upon receipt of a notification matching this subscription. 

notify_arg

The first argument of notify_arg. May be called at any time, by any thread, while the subscription is still active.

cbdone

Called when an unsubscribe completes. It has three Parameters: 

  • cbarg (see below).

  • Status code.

  • A pointer to an opaque subscription object.

cbarg

The first argument of cbdone.

Returns

Nothing.