NWAFPCreateFile(3nw)
NWAFPCreateFile --
creates an AFP file
Synopsis
#include <nwafp.h>
or
#include <nwcalls.h>
NWCCODE NWAPI NWAFPCreateFile
(NWCONN_HANDLE conn,
nuint16 volNum,
nuint32 AFPEntryID,
nuint8 delExistingFile,
pnuint8 finderInfo,
pnstr8 AFPPathString,
pnuint32 newAFPEntryID);
Description
The parameters are as follows:
- conn
-
(IN) Specifies the NetWare server connection handle.
- volNum
-
(IN) Specifies the volume number of the directory's entry location.
- AFPEntryID
-
(IN) Specifies the AFP base ID.
- delExistingFile
-
(IN) Specifies whether to delete the file of the same name (0 = do not delete).
- finderInfo
-
(IN) Points to AFPFILEINFO containing the finder information for the new file.
- AFPPathString
-
(IN) Points to the AFP directory path relative to AFPEntryID.
- newAFPEntryID
-
(OUT) Points to the ID of the newly created directory.
Return values
- 0x0000
-
SUCCESSFUL
- 0x8801
-
INVALID_CONNECTION
- 0x8805
-
NET_RECV_ERROR
- 0x8980
-
ERR_LOCK_FAIL
- 0x8981
-
NO_MORE_FILE_HANDLES
- 0x8983
-
IO_ERROR_NETWORK_DISK
- 0x8984
-
NO_CREATE_PRIVILEGES
- 0x8987
-
WILD_CARDS_IN_CREATE_FILE_NAME
- 0x8988
-
INVALID_FILE_HANDLE
- 0x898A
-
NO_DELETE_PRIVILEGES
- 0x898D
-
SOME_FILES_AFFECTED_IN_USE
- 0x898E
-
NO_FILES_AFFECTED_IN_USE
- 0x898F
-
SOME_FILES_AFFECTED_READ_ONLY
- 0x8990
-
NO_FILES_AFFECTED_READ_ONLY
- 0x8993
-
NO_READ_PRIVILEGES
- 0x8996
-
SERVER_OUT_OF_MEMORY
- 0x8998
-
VOLUME_DOES_NOT_EXIST
- 0x8999
-
DIRECTORY_FULL
- 0x899B
-
BAD_DIRECTORY_HANDLE
- 0x899C
-
INVALID_PATH
- 0x899E
-
INVALID_FILENAME
- 0x89A1
-
DIRECTORY_IO_ERROR
- 0x89A2
-
READ_FILE_WITH_RECORD_LOCKED
- 0x89FD
-
BAD_STATION_NUMBER
- 0x89FF
-
NO_FILES_FOUND_ERROR
- 0x89FF
-
File Exists Error
Notices
The file resulting from NWAFPCreateFile is not opened; it is created as a normal Read/Write file with the system and hidden bits cleared.
For AFPPathString, byte 0 must be the length of the file name. The file name begins at byte 1 of the string. (Only include the file name---not the full path name---when
calling NWAFPCreateFile.)
Services
AppleTalk Filing Protocol
NCP calls
0x2222 35 14 AFP 2.0 Create File
References
AFPFILEINFO,
NWOpenNSEntry(3nw),
NWOpenDataStream(3nw),
NWAFPDelete(3nw),
NWAFPRename(3nw),
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.