NWWriteNSInfo

Sets the specific name space information

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 NWWriteNSInfo ( 
      NWCONN_HANDLE            conn,  
      const NW_IDX N_FAR      *idxStruct,  
      const NW_NS_INFO N_FAR  *NSInfo,  
      const nstr8 N_FAR       *data);

Delphi Syntax

   uses calwin32 
    
   Function NWWriteNSInfo 
     (conn : NWCONN_HANDLE; 
      Var idxStruct : NW_IDX; 
      Var NSInfo : NW_NS_INFO; 
      data : pnuint8 
   ) : NWCCODE;

Parameters

conn: (IN) Specifies the NetWare server connection handle.
idxStruct: (IN) Points to NW_IDX returned by NWNSGetMiscInfo.
NSInfo: (IN) Points to NW_NS_INFO returned by NWGetNSInfo.
data: (IN) Points to a 512-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
0x890A	NLM_INVALID_CONNECTION

Remarks

For name spaces other than DOS, NWWriteNSInfo 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, NWWriteNSInfo 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 NWSetLongName.

NCP Calls

0x2222 87 25 Set NS Information