aglGetShareName

Gets a string identifier that identifies the shared memory region associated with an array.

const char *aglGetShareName(
  void *array
  );

Parameters

array

A pointer to an array either allocated by means of a call to aglAlloc, aglMalloc, or aglMallocEx, or added to the watch list by means of a call to aglStartWatch.

Return Value

A string identifying the array.

Remarks

The string returned by aglGetShareName can be passed to the Avis2D or AvisGrid controls as the FileName property. This allows array data to be displayed by applications that host these controls without saving the array to a disk file.

See Also

aglAlloc, aglMalloc, aglMallocEx, aglStartWatch, Avis2D FileName property, AvisGrid FileName property