BARfly Help - BAR Interfacial Function Reference - BAR_Registry Functions

  BAR_Registry::Get_Last_Error

Purpose: To retrieve the last error associated with the BAR_Registry instance.

long Get_Last_Error();


Parameters

(None)

Return Values

  • 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_INVALID_INDEX: When Query_Position called but no implementation file matches the query, or when Create_BAR or Remove is given an invalid zero-based index as input.
  • BAR_OUT_OF_MEMORY: When not enough memory is available to satisfy Add or Create_BAR.
  • BAR_INVALID_PARAMETER: When any function parameter is invalid.
  • BAR_OBJECT_DESTROYED: When any function is called on an invalid BAR_Registry 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. implementation file).
  • BAR_FILE_WRITE_ERROR: When unable to write to a file in secondary storage (i.e. registry file).
  • BAR_BAD_FORMAT: When an implementation file is invalid and cannot be loaded.
  • BAR_CANNOT_GROW: When Add is called without the BAR_Registry instance having the ability to grow.
  • BAR_ACCESS_DENIED: When unable to load or save a registry file or unable to load an implementation file due to security settings restrictions.

Remarks

Get_Last_Error returns the last error for the BAR_Registry 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.

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]


BARfly Help Copyright © 2009 Christopher Allen