HP-UX SNAplus2 MS Programmer's Guide

Writing MS Applications
Description of the MS API Entry Points
Chapter 2 37
Pointer to a Verb Control Block (VCB) that contains the
parameters for the verb being issued. The VCB
structure for each verb is described in Chapter 3,
“Management Services Verbs.” These structures are
defined in the MS API header file ms_c.h.
comp_proc
The callback routine that SNAplus2 will call when the
verb completes. For more information about the
requirements for a callback routine, see “The Callback
Routine Specified on the ms_async Entry Point”.
corr
An optional correlator for use by the application. This
parameter is defined as a C union so that the
application can specify any of three different
parameter types: pointer, unsigned long, or integer.
SNAplus2 does not use this value, but passes it as a
parameter to the callback routine when the verb
completes. This value enables the application to
correlate the returned information with its other
processing.
Returned Values
The asynchronous entry point returns one of the following values:
AP_COMPLETED
The verb has already completed. The application can
examine the parameters in the VCB to determine
whether the verb completed successfully. SNAplus2
does not call the supplied callback routine for this verb.
AP_IN_PROGRESS
The verb has not yet completed. The application can
continue with other processing, including issuing other
MS verbs, provided that they do not depend on the
completion of the current verb. However, the
application should not attempt to examine or modify
the parameters in the VCB supplied to this verb.