bstr_event_notification_discard(3) — Subroutines

Name

bstr_event_notification_discard − Frees all the resources associated with a received Event notification (VODB only).

Syntax

bstr_t_status bstr_event_notification_discard (
bstr_t_event_notification ∗event_not);

Description

The bstr_event_notification_discard procedure simplifies the release of the API resources associated with a received Event notification. The following resources are discarded:

•The reference to the Event object. (The reference is specified by the event field.)

•The reference to the Event_Set object. (The reference is specified by the event_set field when a value different from NULL is returned.)

•The sequence of the Event parameter values. (The sequence address is specified by the data field.)

This procedure does not free the memory allocated to the bstr_t_event_notification data structure.

Arguments

event_not
access: read/write
The address of a bstr_t_event_notification type data structure whose associated API resources must be discarded.

Return Values

BSTR_S_BAD_PARAMETER	Bad parameter value
BSTR_S_COM_PC_SIZE_MISMATCH	Number of bytes requested does not match the number of bytes returned
BSTR_S_NORMAL	Normal successful completion
BSTR_S_NOT_INITIALIZED	BASEstar Open not initialized