bstr_enbox_get_subscriptions(3) — Subroutines

Name

bstr_enbox_get_subscriptions − Returns a list of all the subscriptions made to an Event notification at an Enbox (PODB only).

Syntax

bstr_t_status   bstr_enbox_get_subscriptions (
                                 bstr_t_reference   enbox,
                                 bstr_t_rcb         ∗control,
                                 bstr_t_sequence    ∗subscriptions);

Description

This procedure retrieves details of the subscriptions to an Event or Event_Set at the enbox Enbox.

Arguments

enbox
access: read
The reference to the Enbox to be accessed.

control
access: read
The address of an optional request control block.

subscriptions
access: write
The address of the sequence which contains the subscriptions. The sequence is of the bstr_t_event_subscription type.

Return Values

BSTR_S_NORMAL	Normal successful completion
BSTR_S_BAD_REFERENCE	Invalid reference
BSTR_S_INVALID_USAGE	Invalid reference usage
BSTR_S_NOT_IMPLEMENTED	Not implemented
BSTR_S_NOT_INITIALIZED	BASEstar Open not initialized

STATUS CODES

None

Examples

bstr_t_status     status;
bstr_t_reference enbox;
bstr_t_rcb        control;
bstr_t_sequence   subscriptions;
   ........
   status = bstr_enbox_get_subscriptions ( enbox,
                                          &control,
                                          &subscriptions);

This example returns all the subscriptions for an Event or an Event_Set at the Enbox enbox.

Museum