(Page 4 of 13 in this chapter)
TxApiIoDest
Description
- Sets the destination entity in the IO packet portion of a TX API packet.
Prototype
- unsigned char *TxApiIoDest (TXMNGPKT *req,
char *pktfname)
- req Pointer to packet for which to set destination.
- pktfname Pointer to destination entity name (may be NULL). Example:
tpx:routes
Return Values
- TX API completion code.
Details
- If the destination string (pktfname) is non-NULL, pktfnsiz (in the IO packet area) is set to the length of pktfname. If pktfname is NULL, pktfnsiz is set to 0. The top of the management packet's datablk is then zero-filled for the maximum destination string size (plus room for NULL-terminator and additional byte to return to even word boundary) (MAXFNA + 2). The destination string is then copied to the first byte of the management packet's data area.
Note: pktfname in the IO packet area is set to zero since that is always the offset into the data block where the destination entity name can be found.
- The maximum destination string size is always reserved by TxApiIoDest.
See Also
- TxApiPktInit
(Page 4 of 13 in this chapter)
tech_support@nmss.com
Copyright © 1998, Natural MicroSystems, Inc. All rights
reserved.