PA_GetLastError

version 2003

PA_GetLastError lastError

Parameter	Type		Description
This command does not require any parameters
Function result	lastError		The last error that occured

The routine PA_GetLastError returns the error code of the most recent error coming from a 4D PluginAPI routine call.

Almost every API routine can generate an error code, however some always return 0 (eER_NoErr).

Error codes are listed in the header file PublicTypes.h and in this documentation, see PA_ErrorCode

eER_NoErr means no error, its value is 0.

It is a good habit to always call PA_GetLastError after a call to any API routine to check if a problem occurred.

When called, PA_GetLastError does not reset the last error.

Allocating and initializing a PA_Handle.

   Somewhere in a header file:
   typedef struct{
      long   magicNumber;
      long   dataSize;
      char   data[1];
   } MyStruct, *MyStructPtr, **MyStructHdle;

   MyStructHdle NewMyStructHandle()
   {
      short   err = eER_NoErr;
      MyStructHdle   h;
   // Allocate the handle
      h = (MyStructHdle) PA_NewHandle(sizeof(MyStruct));
   // Check the error
      err = PA_GetLastError();
      if(!err)
      {
      // OK, the handle was allocated. We can initialize it.
         (*h)->magicNumber = 'TITI';
         (*h)->dataSize = 1;
         (*h)->data[0] = 0;
      }

      return h;
   }

PA_ErrorCode.

Since this is the routine for error handling, it does not generate any error itself.