function [ns_RESULT, hFile] = ns_OpenFile(filename);

%ns_OpenFile   Opens a neural data file
%
%   Usage:
%       [ns_RESULT, hFile] = ns_OpenFile('filename.ext')
%
%   Description:
%       Opens the file specified by filename and returns a file handle, 
%       hFile, that is used to access the opened file.
%
%   Parameters:
%       filename	Pointer to a null-terminated string that specifies the
%                   name of the file to open. 
%
%   Return Values:
%       hFile	    Handle/Indentification number to the opened file.
%       ns_RESULT   This function returns ns_OK if the file is successfully
%                   opened. Otherwise one of the following error codes is 
%                   generated:
%
%                       ns_TYPEERROR	Library unable to open file type
%                       ns_FILEERROR	File access or read error 
%
%   Remarks:
%       All files are opened for read-only, as no writing capabilities have
%       been implemented.  If the command succeeds in opening the file, the
%       application should call ns_CloseFile for each open file before 
%       terminating.
%
%       This function has to be called before any other Neuroshare function
%       is called. 
%
%   Copyright (C) 2003 Neuroshare Project
%   Author: Almut Branner
%   Last modification: 6/20/2003

[ns_RESULT, hFile] = mexprog(1, filename);
