Definition:

#include <aStem.h>
object code: aStem shared library



aLIBRETURN aPacket_GetData(

aStemLib stemRef, const aPacketRef packetRef, unsigned char* pAddress, unsigned char* pLength, char* data, aErr* pErr);

Parameters:

stemRef	-	A pointer to the opaque stem reference used to manage the packet.
packetRef	-	This packet to extract the data from.
pAddress	-	A pointer to an unsigned char that is to receive the packet's address.
pLength	-	A pointer to an unsigned char that is to receive the packet's length.  This length is the data size, not the size of the entire packet which is 2 larger to account for the address and this length byte.
data	-	A pointer to an char buffer that is to receive the packet's data.
pErr	-	A pointer to an aErr variable that recieves the error code on exit from this routine.

Return Value:

This library routine returns an aLIBRETURN type that is non-zero if there are errors, and zero if the routine completes with no errors.

Description:

This routine extract the data from a aPacketRef object.  The internal structure of the packet is private to the library and bound to change so this routine provides access to the data in a packet.  The size of the data parameter must be at least aSTEMMAXPACKETBYTES bytes long to ensure the buffer is not over-run when getting data from an unknown packet.