(Page 24 of 26 in this chapter)
TxTpxRteShNext
Description
- Assists in handling a response packet to a route Show Summary request.
Prototype
- short TxTpxRteShNext (TXMNGPKT *rsp,
unsigned index,
TXAPISHNEXT *nextinfo)
- rsp Pointer to packet holding response to route show summary.
- index Pointer to Index to next route summary to return.
- nextinfo Pointer to area where API can store information about this show.
Return Values
- TX API completion code.
Details
- TxTpxRteShNext locates the next route summary record in the response packet and returns the information from that structure. The route type field will either indicate that all routes have been read (TPX_RTES_DONE) or the specific type of route being returned.
- If DONE is returned, applications should use the repeatflag to determine whether an additional request must be issued to the communications processor. If set, the application should call TxTpxRteShSumm with the index value indicated (followed by a TxApiReqRsp call). If the repeatflag is not set, all routes have been read.
- If a route type is returned, the application should perform any processing required on the returned route description and then issue another call to TxTpxRteShNext to retrieve the next summary description.
See Also
- TxApiReqRsp, TxTpxRteShSumm
(Page 24 of 26 in this chapter)
tech_support@nmss.com
Copyright © 1998, Natural MicroSystems, Inc. All rights
reserved.