Opens a data stream associated with any supported name space on the server
#include <nwnamspc.h>
or
#include <nwcalls.h>
NWCCODE N_API NWOpenDataStream (
NWCONN_HANDLE conn,
nuint8 dirHandle,
const nstr8 N_FAR *fileName,
nuint16 dataStream,
nuint16 attrs,
nuint16 accessMode,
pnuint32 NWHandle,
NWFILE_HANDLE N_FAR *fileHandle);
uses calwin32
Function NWOpenDataStream
(conn : NWCONN_HANDLE;
dirHandle : nuint8;
const fileName : pnstr8;
dataStream : nuint16;
attrs : nuint16;
accessMode : nuint16;
NWHandle : pnuint32;
Var fileHandle : NWFILE_HANDLE
) : NWCCODE;
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the directory handle associated with the directory containing the file. This must be a DOS directory handle; if you want to read from a different namespace, use the dataStream parameter.
(IN) Points to the name of the file containing the data stream. It must be a DOS file name (and match dirHandle). For example, if you are opening a Macintosh file named "alongfilename," pass a DOS dirHandle and the DOS file name "ALONGFIL."
(IN) Specifies the data stream number. To read the primary stream of any file in any namespace, pass 0. For example, to read the data fork of a file in the Macintosh namespace, open a DOS handle, and pass 0. To read the resource fork of a Macintosh handle, pass the DOS directory handle to dirHandle, and pass 1 as the data stream number.
(IN) Specifies the attributes to use in searching for the file to open:
(IN) Specifies the rights to use in opening the file (see Section 20.1, Access Right Values).
(OUT) Points to a 4-byte NetWare handle to dataStream (optional).
(OUT) Points to a file handle.
These are common return values; see Return Values (Return Values for C) for more information.
NWOpenDataStream also obtains a NetWare file handle to a data stream.
If you pass a non-DOS namespace handle to dirHandle, NWOpenDataStream fails.
These constants identify trustee access rights for opening a a directory with NWOpenDataStream.
NWAFPOpenFileFork (Single and Intra-File Management), NWConvertHandle