NWWriteNSInfoExt

Sets the specific name space information, using 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 NWWriteNSInfoExt ( 
      NWCONN_HANDLE            conn,  
      const NW_IDX     N_FAR  *idxStruct,  
      const NW_NS_INFO N_FAR  *NSInfo,  
      const nstr8      N_FAR  *data);

Parameters

conn: (IN) Specifies the NetWare server connection handle.
idxStruct: (IN) Points to NW_IDX returned from NWGetDirectoryBaseExt.
NSInfo: (IN) Points to NW_NS_INFO returned by NWGetNSInfo.
data: (IN) Points to a 1024-byte buffer containing the data to be written to the name space.

Return Values

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

0x0000	SUCCESSFUL
0x8801	INVALID_CONNECTION
0x88F0	UTF8_CONVERSION_FAILED
0x890A	NLM_INVALID_CONNECTION

Remarks

For name spaces other than DOS, NWWriteNSInfoEXT is passed to the appropriate name space NLM on the server. For the DOS name space, the server processes the request.

The actual format of the data is determined by the NLM on the server. Unless format for the data on the server is known, NWWriteNSInfoEXT should not be used.

Avoid setting the first field of the name space information. This is generally the name and is intended to be read-only. To rename a file, call NWNSRenameExt.

NCP Calls

0x2222 87 25 Set NS Information
0x2222 89 25 Enhanced Set NS Information