NWCreateDirectory

Creates a NetWare directory on the specified server

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:File System

Syntax

   #include <nwdirect.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY(NWCCODE) NWCreateDirectory (
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *dirPath,  
      nuint8              accessMask);

Delphi Syntax

   uses calwin32 
    
   Function NWCreateDirectory 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      const dirPath : pnstr8; 
      accessMask : nuint8 
   ) : NWCCODE;

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the directory handle of the root directory for the new directory (0 if the dirPath parameter points to the complete path, including the volume name).

dirPath

(IN) Points to the string containing the name and path of the new directory.

accessMask

(IN) Specifies the access rights mask for the new directory.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x8984

NO_CREATE_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

0x89FD

BAD_STATION_NUMBER

0x89FF

HARDWARE_FAILURE (directory/file already exists)

Remarks

The accessMask parameter can be set using one or more of the following:

Hex

Definition

0xFB

TA_ALL

0x01

TA_READ

0x02

TA_WRITE

0x04

TA_OPEN

0x08

TA_CREATE

0x10

TA_DELETE

0x20

TA_OWNERSHIP

0x40

TA_SEARCH

0x80

TA_MODIFY

NOTE:Actual rights are set according to inherited rights.

NCP Calls

See Also

NWDeleteDirectory