function [ns_RESULT, nsFileInfo] = ns_GetFileInfo(hFile);

%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

[ns_RESULT, nsFileInfo] = mexprog(3, hFile);