PA_GetPointerTableField

version 2003

PA_GetPointerTableField (pointer; table; field)

Parameter	Type		Description
pointer	PA_Pointer		The 4D pointer
table	short *		Table number of the table pointed to by the pointer
field	short *		Field number of the table pointed to by the pointer

The routine PA_GetPointerTableField returns the table and field numbers that pointer references.

Depending on what kind of pointer pointer is, the returned values are:

Pointer kind	*tNum	*fNum
To Field	Table number	Field number
To Table	Table number	0
else	0	0

You can use PA_GetPointerKind to determine what kind of pointer the4Dptr is.

4th Dimension pointers are not standard C pointers. They are structures that tell 4D to what kind of data they point: a table, a field, or a variable (process or interprocess).

Since a pointer does not have the same definition and use in interpreted and compiled mode, the developer should use the accessors of this API.

Using the table number from a pointer to a table:

   /* . . . */
   if ( PA_GetPointerKind( a4Dptr ) == ePK_PointerToTable )
   {
      PA_GetPointerTableField(a4Dptr, &table, &field);
      /* . . . */
   }

PA_GetPointerKind, PA_GetPointerParameter, PA_GetPointerValue, PA_GetPointerVariable.

PA_GetLastError keeps the last error that occurred before calling the routine.