bstr_activity_begin(3) — Subroutines

Name

bstr_activity_begin − Indicates the beginning of an Activity execution (VODB only).

Syntax

bstr_t_status   bstr_activity_begin (
                                  bstr_t_reference   ∗activity,
                                  bstr_t_rcb         ∗control);

Description

The bstr_activity_begin procedure allows the application to specify its intention to begin to act as the Activity execution for the specified activity.

Arguments

activity
access: read
The reference to the Activity object for which the calling application wishes to act as the Activity execution.

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

•The mode field must be set to BSTR_C_SYNCHRONOUS

•The timeout field must be set to 0

•No callback routine can be specified.

Return Values

BSTR_S_ABORTED	Operation aborted
BSTR_S_BAD_PARAMETER	Bad parameter value
BSTR_S_BAD_REFERENCE	Bad reference
BSTR_S_COMMUNICATION_ERROR	Communication error
BSTR_S_FINISH	Request aborted by bstr_finish
BSTR_S_INTERNAL_ERROR	Internal error
BSTR_S_INTR	Operation interrupted
BSTR_S_INVALID_NAME	Invalid name
BSTR_S_INVALID_OPERATION	Invalid operation
BSTR_S_INVALID_RCB	Invalid Request Control Block
BSTR_S_INVALID_USAGE	Invalid reference usage
BSTR_S_NORMAL	Normal successful completion
BSTR_S_NOT_INITIALIZED	BASEstar Open not initialized
BSTR_S_NO_MEMORY	Insufficient virtual memory
BSTR_S_SERVER_NOT_REACHABLE	Server not reachable

Museum