NWRenameObject

Renames an object in the bindery on the server associated with the connection handle

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Bindery

Syntax

C

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWRenameObject ( 
      NWCONN_HANDLE       conn,  
      const nstr8 N_FAR  *oldObjName,  
      const nstr8 N_FAR  *newObjName,  
      nuint16             objType);

Pascal

   uses calwin32 
    
   Function NWRenameObject 
     (conn : NWCONN_HANDLE;    
      const oldObjName : pnstr8; 
      const newObjName : pnstr8; 
      objType : nuint16 
   ) : NWCCODE; stdcall;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
oldObjName
(IN) Points to the name of the currently defined object in the bindery.
newObjName
(IN) Points to the new object name.
objType
(IN) Specifies the type of the object.

Return Values

These are common return values. See Return Values (Return Values for C).

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8996

SERVER_OUT_OF_MEMORY

0x89EE

OBJECT_ALREADY_EXISTS

0x89F0

WILD_CARD_NOT_ALLOWED

0x89F3

NO_OBJECT_RENAME_PRIVILEGE

0x89FC

NO_SUCH_OBJECT

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

The oldObjName, newObjName, and objType parameters must uniquely identify the bindery object and cannot contain wildcard characters. WILD_CARD_NOT_ALLOWED will be returned if the name field strings are not recognized.

Only SUPERVISOR or a bindery object security equivalent to SUPERVISOR can rename bindery objects.

See Object Type.

NCP Calls

See Also

NWScanObject