EssOtlCreateAliasTable

Creates an empty alias table in the outline.

Syntax

ESS_FUNC_M EssOtlCreateAliasTable (hOutline, pszAliasTable);

Parameter	Data Type	Description
hOutline	ESS_HOUTLINE_T	Outline context handle.
pszAliasTable	ESS_STR_T	Name of alias table to create.

Notes

An alias table named “Default” cannot be created, since the default alias table always exists.
The maximum number of alias tables in a single block storage or aggregate storage database outline (including the default table) is 32.
You can specify multiple language codes for an alias table, using the EssOtlSetAliasTableLanguage API. When you create an alias table, a language code is not specified.

Return Value

Returns 0 if successful; otherwise one of the following:

OTLAPI_ERR_ALIASTABLEEXISTS
OTLAPI_ERR_MAXALIASTABLES
OTLAPI_ERR_ALIASTABLENAME

Example

#include <essapi.h>
#include <essotl.h>

ESS_STS_T          sts = 0;
ESS_OUTLINEINFO_T  NewInfo;
ESS_HOUTLINE_T     hOutline;

memset(&NewInfo, '\0', sizeof(NewInfo));
sts = EssOtlNewOutline(hCtx, &NewInfo,
      &hOutline);

if (!sts)
{
   sts = EssOtlCreateAliasTable(hOutline, 
   "Alias Table 1");
}