ASAP 1.1 Hybrid Manual

HP NonStop ASAP Hybrid Manual – 529729-004
Page 4-22
Return Values
ASAP_ERROR_NONE (0)
No error. Operation was successful.
ASAP_ERROR_INVALID_PARAM (-101)
A parameter was invalid. If specified, *ptr_error_detail contains the incorrect
parameter number (first param = 1).
ASAP_ERROR_REMOVED (-111)
The domain has been removed. Once cleanup occurs, the domain can be
reregistered.
ASAP_ERROR_HOST_DOMAIN (-112)
There is a problem with this domain on the NonStop server. Updates continue to
occur locally on the Linux system and are sent to the server. However, the server
might not be able to update or display this data. *ptr_error_detail contains the
NonStop server error number.
ASAP_ERROR_MUTEX (applies to asap_control_ts only) (-113)
No mutex was allocated for this domain, or there was an error accessing the
mutex. The operation is not performed. To activate or deactivate ranking, the
application must use the standard asap_control call.
Differences from the NonStop ASAPX API
 The flags parameter has been replaced by the Boolean parameter
rank_enabled_ind, but this parameter still has the same purpose: to indicate
whether ranking should be enabled or disabled.
 A different range of values and possible errors is returned.
Example
short ErrorDetail; // Error detail from call
short ReturnValue; // Return value from call
ReturnValue = ::asap_control(Handle, // Handle from asap_register
false, // Disable ranking
&ErrorDetail); // Returned error information