NWSetNSEntryDOSInfo

Modifies information in one name space using a path from another name space

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 NWSetNSEntryDOSInfo ( 
      NWCONN_HANDLE           conn,  
      nuint8                  dirHandle,  
      const nstr8 N_FAR      *path,  
      nuint8                  namSpc,  
      nuint16                 searchAttrs,  
      nuint32                 modifyDOSMask,  
      MODIFY_DOS_INFO N_FAR  *dosInfo);

Delphi Syntax

   uses calwin32 
    
   Function NWSetNSEntryDOSInfo 
     (conn : NWCONN_HANDLE; 
      dirHandle : nuint8; 
      path : pnstr8; 
      namSpc : nuint8; 
      searchAttrs : nuint16; 
      modifyDOSMask : nuint32; 
      Var dosInfo : MODIFY_DOS_INFO 
   ) : NWCCODE;

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the directory handle of the parent directory.

path

(IN) Points to the path.

namSpc

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

searchAttrs

(IN) Specifies the search attributes to use.

modifyDOSMask

(IN) Specifies the information to set.

dosInfo

(IN) Points to MODIFY_DOS_INFO containing the information specified by luModifyDOSMask.

Return Values

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

0x0000

SUCCESSFUL

0x89FF

NO_FILES_FOUND_ERROR

Remarks

suSrchAttr can have the following values:

C Value

Delphi Value

Value Name

0x0002

$0002

SA_HIDDEN

0x0004

$0004

SA_SYSTEM

0x0010

$0010

SA_SUBDIR_ONLY

0x8000

$8000

SA_SUBDIR_FILES

luModifyDOSMask can have the following values:

C Value

Delphi Value

Value Name

0x0002L

$0002

DM_ATTRIBUTES

0x0004L

$0004

DM_CREATE_DATE

0x0008L

$0008

DM_CREATE_TIME

0x0010L

$0010

DM_CREATOR_ID

0x0020L

$0020

DM_ARCHIVE_DATE

0x0040L

$0040

DM_ARCHIVE_TIME

0x0080L

$0080

DM_ARCHIVER_ID

0x0100L

$0100

DM_MODIFY_DATE

0x0200L

$0200

DM_MODIFY_TIME

0x0400L

$0400

DM_MODIFIER_ID; cannot be set for subdirectories

0x0800L

$0800

DM_LAST_ACCESS_DATE; cannot be set for subdirectories

0x1000L

$1000

DM_INHERITED_RIGHTS_MASK

0x2000L

$2000

DM_MAXIMUM_SPACE

DM_MODIFIER_ID and DM_LAST_ACCESS_DATE cannot be used when the suSrchAttr parameter contains SA_SUBDIR_ONLY. The server masks off DM_MODIFIER_ID and DM_LAST_ACCESS_DATE on subdirectories. If the resultant mask is 0x0000, the server will return NO_FILES_FOUND_ERROR indicating DM_MODIFIER_ID and DM_LAST_ACCESS_DATE were not set. If the resultant mask still contains a return value other than SUCCESSFUL, NWSetNSEntryDOSInfo will set the remaining bits and return SUCCESSFUL even though DM_MODIFIER_ID and DM_LAST_ACCESS_DATE were not set.

NCP Calls