NWOpenCreateNSEntry

Opens a file in the specified name space or creates and then opens a file if it does not already exist

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Name Space

Syntax

   #include <nwnamspc.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API  NWOpenCreateNSEntry  ( 
      NWCONN_HANDLE             conn,  
      nuint8                    dirHandle,  
      nuint8                    namSpc,  
      const pnstr8      N_FAR   path,  
      NW_NS_OPENCREATE  N_FAR  *NSOpenCreate,  
      NWFILE_HANDLE     N_FAR  *fileHandle);
   

Delphi Syntax

   uses calwin32 
    
   Function NWOpenCreateNSEntry 
     (conn : NWCONN_HANDLE; 
      dirHandle : nuint8; 
      namSpc : nuint8; 
      const path : pnstr8; 
      Var NSOpenCreate : NW_NS_OPENCREATE; 
      Var fileHandle : NWFILE_HANDLE 
   ) : NWCCODE;
   

Parameters

conn

(IN) Specifies the NetWare connection handle.

dirHandle

(IN) Specifies the directory handle on which to open/create the specified file.

namSpc

(IN) Specifies the name space of dirHandle/path (see Section 20.5, Name Space Flag Values).

path

(IN) Points to an absolute path (or relative if dirHandle is nonzero).

NSOpenCreate

(IN/OUT) Points to NW_NS_OPENCREATE containing information needed to create the entry on input. Points to NW_NS_OPENCREATE containing the results of a successful open/create upon output.

fileHandle

(OUT) Points to the NWFILE_HANDLE. When you are creating subdirectories, fileHandle returns zero.

Return Values

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

0x0000

SUCCESSFUL

0x8980

ERR_LOCK_FAIL

0x8981

NO_MORE_FILE_HANDLES

0x8982

NO_OPEN_PRIVILEGES

0x8994

NO_WRITE_PRIVILEGES_OR_READONLY

0x8996

SERVER_OUT_OF_MEMORY

0x8998

SERVER_DOES_NOT_EXIST

0x899C

INVALID_PATH

0x89A1

DIRECTORY_IO_ERROR

0x89FD

BAD_STATION_NUMBER

0x89FF

Failure

NCP Calls

See Also

NWDeleteNSEntry