ns_GetFileInfo

 ns_GetFileInfo   Retrieves file information and entity counts

    Usage:
        [ns_RESULT, nsFileInfo] = ns_GetFileInfo(hFile)

    Description:
        Provides general information about the data file referenced by 
        hFile. This information is returned in the structure nsFileInfo.

    Parameters:
        hFile           Handle/Indentification number to an open file.

    Return Values:
        nsFileInfo  ns_FILEINFO structure that receives the file
                    information.
        ns_RESULT   This function returns ns_OK if the file is successfully
                    opened. Otherwise one of the following error codes is 
                    generated:

                        ns_FILEERROR    File access or read error
                        ns_BADFILE      Invalid file handle passed to
                                        function

    Copyright (C) 2003 Neuroshare Project
    Author: Almut Branner
    Last modification: 2/4/2003