HP-UX SNAplus2 CSV Programmer's Guide

Concepts

CSV Entry Points: Windows

Chapter 1 29

FALSE An error occurred during processing of the call, and the

application was not unregistered. Check the log ﬁles for

messages indicating the cause of the failure.

GetCsvReturnCode

This call returns a printable character string interpreting the return

codes from a supplied VCB. The string can be used to generate

application error messages for return codes other than AP_OK.

This call is designed to provide strings for display to the end user of an

application. For return codes indicating conﬁguration problems or user

errors (for example if a required component is not conﬁgured or not

started), the string should provide sufﬁcient information to help the user

correct the problem. For return codes indicating application errors (for

example, if the application has issued a verb that is not valid or failed to

supply a required parameter), the user will not generally be able to

correct the problem; in these cases, the string may be meaningful only to

an application developer.

Function Call

int WINAPI LOADDS GetCsvReturnCode (

struct svc_hdr FAR * vcbbptr,

unsigned int buffer_length,

unsigned char FAR * buffer_addr

);

struct svc_hdr

{

unsigned short opcode; /* Verb identifying operation code. */

unsigned char opext; /* Verb extension code - reserved. */

unsigned char reserv2; /* Reserved. */

unsigned short primary_rc; /* Primary return code from verb. */

unsigned long secondary_rc; /* Secondary (qualifying) return code. */

Supplied Parameters

The supplied parameters are:

vcbptr

A pointer to the VCB structure for the verb. For more

information about the VCB structure and on its usage

for individual verbs, see Chapter 2, “Common Service

Verbs Reference.”