long Get_Last_Error();
long Get_Last_Opcode_Error();
long Get_Last_Failure_Location();

Parameters

(None)

Return Values

  On success...

• Get_Last_Error
  • BAR_NO_ERROR: No error condition.
  • BAR_LOCK_TIMEOUT: When unable to complete function call due to the object being temporarily unavailable (locked for usage by another thread).
  • BAR_OUT_OF_MEMORY: When not enough system memory available to satisfy the memory requirement settings on initialization, or when not enough requisitioned memory available to satisfy Create_BAR or Create_BAR_Registry.
  • BAR_INVALID_PARAMETER: When any function parameter is invalid.
  • BAR_OBJECT_DESTROYED: When any function is called on an invalid BAR_Services object.
  • BAR_FILE_OPEN_ERROR: When unable to open a file in secondary storage (i.e. registry file or implementation file).
  • BAR_FILE_READ_ERROR: When unable to read from a file in secondary storage (i.e. registry file or implementation file).
  • BAR_BAD_FORMAT: When a registry file or implementation file is invalid and cannot be loaded.
  • BAR_ACCESS_DENIED: When unable to load a file (i.e. registry file or implementation file) due to security settings restrictions.
• Get_Last_Opcode_Error:  Click here for opcode error codes.
• Get_Last_Failure_Location:  A script opcode address.

  On failure...

• A negative value

Remarks

Get_Last_Error returns the last error for the BAR_Services instance.  A nonnegative value indicates no error; a negative value indicates an error.  The general pattern for return values for Get_Last_Error functions is always negative for error.

Get_Last_Opcode_Error returns the last opcode error for the BAR_Services instance.  This function only returns valid results after a function in an implementation file was just called (explicitly, or as part of deserialization or serialization operation).

Get_Last_Failiure_Location returns the last failure location (opcode index at time of opcode error). This function only returns valid results after a function in an implementation file was just called and there was an opcode error.

Compatibility

	All Platforms	Win32 C++ LIB
BAR version	1.1	1.1
	All Platforms	Win32
BARfly version	1.0	1.0

  See also:  [BAR_Services Functions] [BAR_Registry Functions] [BAR Functions]