NWSetNSEntryDOSInfoExt

Modifies information in one name space using a path from another name space and UTF-8 strings

Local Servers:blocking
Remote Servers:blocking
NetWare Server:6.5 SP2 or later
Platform:NLM, Windows 2000, Windows XP
Client:4.90 SP2 or later
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Name Space

Syntax

   #include <nwnamspc.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWSetNSEntryDOSInfoExt ( 
      NWCONN_HANDLE           conn,  
      nuint8                  dirHandle,  
      const nstr8     N_FAR  *path,  
      nuint8                  namSpc,  
      nuint16                 searchAttrs,  
      nuint32                 modifyDOSMask,  
      MODIFY_DOS_INFO N_FAR  *dosInfo);
   

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. The characters in the string must be UTF-8.

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 (see Remarks for values).

modifyDOSMask

(IN) Specifies the information to set (see Remarks for values).

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

0x88F0

UTF8_CONVERSION_FAILED

0x89FF

NO_FILES_FOUND_ERROR

Remarks

suSrchAttr can have the following values:

C Value

Value Name

0x0002

SA_HIDDEN

0x0004

SA_SYSTEM

0x0010

SA_SUBDIR_ONLY

0x8000

SA_SUBDIR_FILES

luModifyDOSMask can have the following values:

C Value

Value Name

0x0002L

DM_ATTRIBUTES

0x0004L

DM_CREATE_DATE

0x0008L

DM_CREATE_TIME

0x0010L

DM_CREATOR_ID

0x0020L

DM_ARCHIVE_DATE

0x0040L

DM_ARCHIVE_TIME

0x0080L

DM_ARCHIVER_ID

0x0100L

DM_MODIFY_DATE

0x0200L

DM_MODIFY_TIME

0x0400L

DM_MODIFIER_ID; cannot be set for subdirectories

0x0800L

DM_LAST_ACCESS_DATE; cannot be set for subdirectories

0x1000L

DM_INHERITED_RIGHTS_MASK

0x2000L

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, NWSetNSEntryDOSInfoExt will set the remaining bits and return SUCCESSFUL even though DM_MODIFIER_ID and DM_LAST_ACCESS_DATE were not set.

NCP Calls