VaultSize Property

The actual size of the vault.

Syntax

ANSI (Cross Platform)
int64 GetVaultSize();
int SetVaultSize(int64 lVaultSize);

Unicode (Windows)
LONG64 GetVaultSize();
INT SetVaultSize(LONG64 lVaultSize);
@property (nonatomic,readwrite,assign,getter=vaultSize,setter=setVaultSize:) long long vaultSize;
- (long long)vaultSize;
- (void)setVaultSize:(long long)newVaultSize;

#define PID_CBVAULT_VAULTSIZE 24

CBFSVAULT_EXTERNAL void* CBFSVAULT_CALL CBFSVault_CBVault_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
CBFSVAULT_EXTERNAL int CBFSVAULT_CALL CBFSVault_CBVault_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);

Default Value

0

Remarks

This property specifies the actual size of the vault, in bytes.

Applications may use this property to explicitly resize a vault, keeping in mind the following:

  • A vault cannot shrink more than its available free space allows (i.e., not by more than VaultFreeSpace bytes).
  • A vault cannot shrink beyond VaultSizeMin bytes.
  • If VaultSizeMax is not 0 (unlimited), a vault cannot grow beyond VaultSizeMax bytes.
  • If a vault grows enough to reach/exceed its AutoCompactAt threshold, it will automatically shrink again when the next automatic compaction occurs.

Applications can also determine the maximum size a vault could possibly be by querying the PossibleSize property. Please refer to the Vault Size topic for more information.

Note: This property can only be changed when Active is true, and cannot be changed within events.

This property is not available at design time.

Data Type

Long64
Copyright (c) 2022 Callback Technologies, Inc. - All rights reserved.
CBFS Vault 2020 C++ Edition - Version 20.0 [Build 8347]