Digital

NAME

X25GetItemList − Lists item codes in an Encoded Parameter List

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

#include <netx25/x25.h>
int X25GetItemList(

unsigned char ∗ epl ,
int eplLength ,
short itemList[] ,
int maxItem );

PARAMETERS

eplPoints to the Encoded Parameter List from which to extract the items. 

eplLengthSpecifies the length of the Encoded Parameter List epl. 

itemListSpecifies an array of shorts in which the list of parameter codes is to be returned. 

maxItemSpecifies the size of the array pointed to by itemList. 
 

DESCRIPTION

 
If successful, this routine returns the list of items that are encoded in the encoded parameter list epl.  The item codes returned are defined in the x25.h include file and described in the X.25 for Digital UNIX − Programmer’s Reference Manual. 
 

RETURN VALUES

Upon successful completion, the X25GetItemList routine returns the number of items in the EPL.  Otherwise, a (negative) error code is returned. 
 

ERRORS

 
If the X25GetItemList routine fails, one of the following error codes is returned:

[X25RC_BADEPL]
The specified EPL is not a correctly formatted EPL.  Either the epl parameter does not contain a valid EPL, or the eplLength parameter does not match the EPL. 

[X25RC_USRBUFSIZE]
The specified buffer is too small to contain the requested data.  The itemList parameter is not big enough to contain the list of item codes extracted from the EPL.  As many of the item codes as will fit are returned in itemList. 
 

RELATED INFORMATION

Functions: X25Decode(3X25), X25Encode(3X25). 

X.25 for Digital UNIX − Programmer’s Reference Manual.