BAR_Interface Create_BAR(BAR_Identifier BAR_ID);
BAR_Registry_Interface Create_BAR_Registry(BAR_Registry_Identifier Registry_ID, bool Can_Grow);

Parameters

• BAR_Identifier BAR_ID:  A BAR identifier (platform-dependent) to refer to the source data.
• BAR_Registry_Identifier Registry_ID:  A registry identifier (platform-dependent) to refer to the source data.
• bool Can_Grow:  Determines whether registry has growth capability.

Return Values

• Non-null:  Successful creation.
• Null:  Unsuccessful creation.

Remarks

Create_BAR creates a BAR interfacial object and returns an interface to the object. Create_BAR loads a BAR implementation file into memory and prepares the object for calls to the interface.

BAR_ID is a platform-dependent identifier for an existing BAR implementation file.

Create_BAR_Registry creates a BAR_Registry interfacial object and returns an interface to the object.  Create_BAR_Registry loads a registry file into memory and prepares the object for calls to the interface.

Registry_ID is a platform-dependent identifier for an existing registry. If Registry_ID is populated with BAR_Registry_ID_New, an empty registry is created.

A registry is only allowed to grow if Can_Grow is set to true.

Common implementations of both BAR_Identifier and BAR_Registry_Identifier include strings (disk files) and pointers to memory (memory files).

Compatibility

	All Platforms	Win32 C++ LIB
BAR version	1.1	1.1
	All Platforms	Win32
BARfly version	n/a	n/a

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