NWWriteFile(3nw)


NWWriteFile -- writes data to specified file

Synopsis

   #include <nwfile.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWWriteFile (NWFILE_HANDLE fileHandle, nuint32 bytesToWrite, pnuint8 data);

Description

The parameters are as follows:

fileHandle
(IN) Specifies the file handle to write data to.

bytesToWrite
(IN) Specifies the number of bytes to write to the file.

data
(IN) Points to the data to write to the specified file.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8983
IO_ERROR_NETWORK_DISK

0x8988
INVALID_FILE_HANDLE

0x8994
NO_WRITE_PRIVILEGES_OR_READONLY

0x8995
FILE_DETACHED

0x89A2
READ_FILE_WITH_RECORD_LOCKED

0x89FF
IO_BOUND_ERROR

Notices

This function fails if the client does not have write access to the indicated file, or if some portion of the targeted block is locked for use by a different client.

This function does not currently buffer data. Performance is affected by multiple short writes.

Services

File I/O

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 22 Get Station's Logged Info (old)
0x2222 23 28 Get Station's Logged Info
0x2222 73 - Write To A File
0x2222 104 01 Ping for NDS NCP

 
 0x2222   23    17   Get File Server 
                     Information 
 0x2222   23    22   Get Station's 
                     Logged Info 
                     (old) 
 0x2222   23    28   Get Station's 
                     Logged Info 
 0x2222   73    -    Write To A File 
 0x2222   104   01   Ping for NDS 
                     NCP 

References

NWReadFile(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.