# EssOtlNewOutline

Description

EssOtlNewOutline() creates an outline without creating a file. This call is used as an alternative to EssOtlOpenOutline().

Syntax

    ESS_FUNC_M EssOtlNewOutline (hCtx, pNewInfo, phOutline);

ESS_HCTX_T | hCtx
ESS_POUTLINEINFO_T | pNewInfo
ESS_PHOUTLINE_T | phOutline

Parameters

hCtx | Essbase Context handle.
pNewInfo | Structure describing the new outline.
phOutline | Pointer to ESS_HOUTLINE_T variable. This handle is set by the API and should be passed in to subsequent Outline API functions.

Return Value

Returns 0 if successful.

Notes

- This function creates an empty outline in memory.
- No transactions are kept when this call is used. See EssOtlOpenOutline() for more information on keeping transactions.

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

See Also

EssOtlOpenOutline()
EssOtlWriteOutline()
EssOtlRestructure()
EssOtlCloseOutline()
EssOtlVerifyOutline()