HP-UX SNAplus2 MS Programmer's Guide

Writing MS Applications
Description of the MS API Entry Points
Chapter 2 39
void * msvcb,
AP_CORR corr
);
typedef union ap_corr {
void * corr_p;
unsigned long corr_l;
int corr_i;
} AP_CORR;
Supplied Parameters
SNAplus2 calls the callback routine with the following parameters:
target_handle
For MS data and status indications, SNAplus2 passes
the target handle that was supplied with the
REGISTER_MS_APPLICATION or
REGISTER_NMVT_APPLICATION verb. For
completion of verbs, this parameter is undefined.
msvcb
One of the following:
• For MS data and status indications, a pointer to a
VCB supplied by SNAplus2.
• For completion of verbs, a pointer to the VCB
supplied by the application. The VCB now includes
the returned parameters set by SNAplus2.
corr
The correlator value supplied by the application. This
value enables the application to correlate the returned
information with its other processing.
The callback routine need not use all of these parameters (except as
described in “Using the Callback Routine for Indications”). The callback
routine can perform all the necessary processing on the returned
parameters, or it can simply set a variable to inform the MS application
that the verb has completed.
Returned Values
The callback function does not return any values.