Syntax

  #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);
  

Delphi Syntax

  uses calwin32 
   
  Function NWAFPCreateFile 
    (conn : NWCONN_HANDLE; 
     volNum : nuint16; 
     AFPEntryID : nuint32; 
     delExistingFile : nuint8; 
     finderInfo : pnuint8; 
     AFPPathString : pnstr8; 
     newAFPEntryID : pnuint32 
  ) : NWCCODE;
  

Parameters

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

These are common return values; see Return Values (Return Values for C) for more information.

Remarks

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.)

NCP Calls

• 0x2222 35 14 AFP 2.0 Create File

See Also

NWOpenNSEntry, NWOpenDataStream (Multiple and Inter-File Services), NWAFPDelete, NWAFPRename