RSC/MP Programming Manual

API Function Descriptions RscErrorInfo [RSCERI]
puTextLength
If not NULL, on input this field points to the maximum number of characters the
function should copy to the location specified by pcErrorText. On output, this field
points to the actual number of characters copied. puTextLength must not be NULL
if pcErrorText is not NULL. RSC/MP errors have a maximum length of the
RSC_MAX_ERR_LENGTH constant.
Return Value
The return value is RSC_UNCLASSIFIED_ERROR if the value supplied in
uErrorCode is not a recognizable RSC/MP error code.
When a recognizable RSC/MP error code is supplied in uErrorCode, the return
value is also known as the error class and is produced by a bitwise OR of the error
type and the error severity. To isolate the error type, AND the error class with (0F0
HEX). To isolate the error severity, AND the error class with (0F HEX).
These are the error types and their meaning:
Error Type Meaning
RSC_CONNECT_ERROR The error was reported by the
communications subsystem that
processed the request. The
connection being attempted or
currently in use was abnormally
terminated.
RSC_IO_ERROR The error was reported by the
NonStop subsystem that processed
the request. The I/O operation being
attempted was unsuccessful.
RSC_PROGRAM_ERROR The error was caused by an
application programming error.
RSC_SESSION_ERROR The error was the result of a failure of
or the misuse of the session handle
used to process the request. The
session being attempted or currently
in use was abnormally terminated.
RSC_UNCLASSIFIED_ERROR The error cannot be categorized into
any known type.
HP NonStop Remote Server Call (RSC/MP) Programming Manual — 522360-006
10 - 14