[Top] [Prev] [Next] [Bottom]

ANstart/afstart

int32 ANstart(int32 file_id)
file_id

IN:

File identifier returned by Hopen

Purpose

Initializes the multifile annotation interface.

Return value

Returns an interface identifier if successful and FAIL (or -1) otherwise.

Description

This routine is used with the ANend routine to define the extent of a multifile annotation interface session. ANstart initializes the internal interface structures needed for the remaining AN routines. Use the general purpose routines Hopen and Hclose to manage file access as the AN routines will not open and close HDF files.

Example

This example illustrates the use of ANstart and ANend in initializing and terminating an AN interface session.

	#include "hdf.h"
	int32 an_id, file_id, stat;

	file_id = Hopen("myfile", DFACC_WRITE, 0);
	an_id = ANstart(file_id);
	       ...
	stat = ANend(an_id);
	Hclose(file_id); 
FORTRAN

integer function afstart(file_id)

integer file_id



[Top] [Prev] [Next] [Bottom]

hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.