# EssOtlCreateAliasTable

Description

EssOtlCreateAliasTable() creates an empty alias table in the outline.

Syntax

    ESS_FUNC_M EssOtlCreateAliasTable (hOutline, pszAliasTable);

ESS_HOUTLINE_T | hOutline
ESS_STR_T | pszAliasTable

Parameters

hOutline | Outline context handle.
pszAliasTable | Name of alias table to create.

Return Value

Returns 0 if successful; otherwise one of the following:

OTLAPI_ERR_ALIASTABLEEXISTS
OTLAPI_ERR_MAXALIASTABLES
OTLAPI_ERR_ALIASTABLENAME

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 outline (including the default table) is 10.

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");
    }

See Also

EssOtlCopyAliasTable()
EssOtlRenameAliasTable()
EssOtlDeleteAliasTable()