AIDA_hCreateStack

The AIDA_hCreateStack function creates a new AIDA stack.

handle AIDA_hCreateStack(
  void
);

Parameters

none

Return Values

AIDA_hCreateStack returns a handle for the created AIDA stack.

If the function fails, the return value is NULL. The application can retrieve the error code using AIDA_iGetError.

Remarks

The returned handle has to be treated as opaque value.

Example

/* CREATESTACK.C: This program creates an AIDA
 * stack and deletes it afterwards.
 */

#include <stdio.h>
#include <errno.h>
#include "bsk_aida.h";

void main( void )
{
  handle hStack;

  /* Create a stack */
  hStack = AIDA_hCreateStack();
  if( hStack == NULL )
    printf( "Error creating stack: %d\n", AIDA_iGetError() );
  else
  {
    printf( "Stack created.\n" );
    if( !AIDA_boDeleteStack( hStack ) )
      printf( "Error deleting stack: %d!\n", AIDA_iGetError );
    else
      printf( "Stack deleted.\n" );
  }
}

Output

Stack created
Stack deleted

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Linux: Requires a kernel supporting ELF binaries.
  Header: Declared in bsk_aida.h, also requires portab.h.
  Import Library (Windows): Use BSK_AIDA.lib.