# EsbOtlNewOutline

Description

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

Syntax

    EsbOtlNewOutline (hCtx, pNewInfo, phOutline)

    ByVal hCtx      As Long
          pNewInfo  As ESB_OUTLINEINFO_T
          phOutline As Long

Parameters

hCtx | Essbase Context handle.
pNewInfo | Structure describing the new outline.
phOutline | Return variable for the ESB_HOUTLINE_T value. This handle is set by the API and should be passed 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 EsbOtlOpenOutline() for more information on keeping transactions.

Example

    Declare Function EsbOtlNewOutline Lib
    "ESBOTLW.DLL" (ByVal hCtx As Long, pNewInfo As ESB_OUTLINEINFO_T,
    phOutline As Long) As Long

    Sub ESB_OtlNewOutline()
    Dim sts As Long
    Dim NewInfo As ESB_OUTLINEINFO_T
    Dim hOutline As Long

    NewInfo.usOutlineType = ESB_DBTYPE_NORMAL
    NewInfo.fCaseSensitive = ESB_FALSE
    NewInfo.fAutoConfigure = ESB_TRUE

    sts = EsbOtlNewOutline(hCtx, NewInfo, hOutline)
    End Sub

See Also

EsbOtlOpenOutline()
EsbOtlWriteOutline()
EsbOtlRestructure()
EsbOtlCloseOutline()
EsbOtlVerifyOutline()