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

Parameter	Data Type	Description
hCtx	ESS_HCTX_T	Essbase Context handle.
pNewInfo	ESS_OUTLINEINFO_T	Structure describing the new outline.
phOutline	ESS_PHOUTLINE_T	Pointer to ESS_HOUTLINE_T variable. This handle is set by the API and should be passed in to subsequent Outline API functions.

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.

Return Value

Returns 0 if successful.

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