WEB_STORAGE_QUOTA Structure  
 

The WEB_STORAGE_QUOTA structure contains information about the current storage account data usage and limits. This structure is used with the WebGetStorageQuota function.

typedef struct _WEB_STORAGE_QUOTA
{
    DWORD     dwObjects;
    DWORD     dwObjectLimit;
    DWORD     dwObjectSize;
    ULONGLONG ulBytesUsed;
    ULONGLONG ulBytesFree;
    ULONGLONG ulStorageLimit;
} WEB_STORAGE_QUOTA, *LPWEB_STORAGE_QUOTA;

Members

dwObjects
An unsigned integer value which specifies the number of storage objects allocated for the account. This value may not exceed the total number of objects specified by the dwObjectLimit member.
dwObjectLimit
An unsigned integer value which specifies the maximum number of storage objects that may be created. In addition to the limit on the total amount of storage that may be used, there is a limit on the total number of objects that may be created by all applications.
dwObjectSize
An unsigned integer value which specifies the maximum size of an individual storage object. In addition to a limit on the total amount of storage used and the number of objects created, each object stored by the application cannot exceed this size.
ulBytesUsed
An unsigned 64-bit integer value which specifies the total number of bytes of data allocated for all storage objects. This value may not exceed the total number of bytes of storage available, which is specified by the ulStorageLimit member.
ulBytesFree
An unsigned 64-bit integer value which specifies the number of bytes available for the storage of new objects. This value reflects the total amount of available storage across all applications registered with the development account. If this value is zero, your storage account has reached its storage limit.
ulStorageLimit
An unsigned 64-bit integer value which specifies the maximum number of bytes of data storage available. This limit applies to all applications registered with the development account.

Remarks

Storage quota limits are assigned for each SocketTools development account. The WebGetStorageQuota function will populate this structure with information about the limits on your account. Accounts that are created with an evaluation license have much lower quota limits than a standard account and should be used for testing purposes only. After the evaluation period has ended, all objects stored using the evaluation license will be deleted.

These values do not represent limits on storage usage by a specific application. Quotas limits apply to all applications that are registered with the development account, which is identified with the runtime license key passed to the WebInitialize function.

If your storage quota has been exceeded, either because the total number of objects or the total bytes of storage has reached their limit, your applications will be unable to create new objects. Your application can continue to access existing objects, regardless of your current quota limits.

To free storage space, use the WebDeleteObject function to delete individual storage objects that are no longer needed by your application, or use the WebResetStorage function to delete all objects in a container.

Requirements

Minimum Desktop Platform: Windows 7 (Service Pack 1)
Minimum Server Platform: Windows Server 2008 R2 (Service Pack 1)
Header: Include cstools10.h

See Also

WebGetStorageQuota