bstr_event_enable_subscription(3) — Subroutines
Name
bstr_event_enable_subscription − Enables an Event subscription.
Syntax
bstr_t_status bstr_event_enable_subscription (
bstr_t_reference ∗event,
bstr_t_reference ∗enbox,
bstr_t_rcb ∗control);
Description
If a subscription to the event Event or Event_Set exists at the specified enbox, the bstr_event_enable_subscription procedure enables the delivery of notifications at the enbox.
Arguments
event
access: read
The reference to the Event (or Event_Set) associated with the subscription.
enbox
access: read
The reference to the Enbox associated with the subscription.
control
access: read
The address of an optional request control block.
Return Values
| BSTR_S_ABORTED | Operation aborted |
| BSTR_S_ALREADY_ENABLED | Already enabled |
| BSTR_S_BAD_PARAMETER | Bad parameter value |
| BSTR_S_BAD_REFERENCE | Bad reference |
| BSTR_S_COMMUNICATION_ERROR | Communication error |
| BSTR_S_COM_PC_SIZE_MISMATCH | Number of bytes requested does not match the number of bytes returned |
| BSTR_S_FINISH | Request aborted by bstr_finish |
| BSTR_S_INTERNAL_ERROR | Internal error |
| BSTR_S_INTR | Operation interrupted |
| BSTR_S_INVALID_RCB | Invalid Request Control Block |
| BSTR_S_INVALID_USAGE | Invalid reference usage |
| BSTR_S_NORMAL | Normal successful completion |
| BSTR_S_NOT_IMPLEMENTED | Not yet implemented |
| BSTR_S_NOT_INITIALIZED | BASEstar Open not initialized |
| BSTR_S_NO_MEMORY | Insufficient virtual memory |
| BSTR_S_OBJECT_NOT_FOUND | Object not found |
| BSTR_S_SERVER_NOT_REACHABLE | Server not reachable |
| BSTR_S_TIMEOUT | Timeout expired |
| BSTR_S_TOO_MANY_REQUESTS | Too many pending requests |
See Also
| bstr_event_add_subscription | # |
| bstr_event_disable_subscription | # |
| bstr_event_get_subscriptions | # |
| bstr_event_remove_subscription | # |