AIDA_xsComponentName

The AIDA_xsComponentName function retrieves the name of a component that is part of the given stack.

const xchar *AIDA_xsComponentName(
  handle hStack,
  byte bStackLevel,
);

Parameters

hStack

Handle to a stack previously created by AIDA_hCreateStack, AIDA_hCreateStackEx, AIDA_hRestoreStack, AIDA_hRestoreStackRaw or AIDA_hRestoreStackEx.

bLevel

Stacklevel of a component previously added to the stack by AIDA_bAddToStack

Return Values

AIDA_xsComponentName returns the name of the component specified by hStack and bStackLevel with its path and extension.

If the function fails, the returned value is NULL.

Remarks

Attention: Stack manipulation functions and component configuration functions may not be called simultaneously from different threads with the same handle or otherwise will cause unpredictable results.

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.

See Also

AIDA Overview, AIDA Functions, AIDA_hCreateStack, AIDA_hCreateStackEx, AIDA_boDeleteStack, AIDA_boSaveStack, AIDA_hRestoreStack, AIDA_hRestoreStackRaw, AIDA_hRestoreStackEx, AIDA_pastSetReplacementTable, AIDA_bAddToStack, AIDA_boRemoveFromStack