NWGetObjectName

Returns the name and object type of a bindery object on the network server

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  NWGetObjectName  ( 
      NWCONN_HANDLE   conn,  
      nuint32         objID,  
      pnstr8          objName,  
      pnuint16        objType);
   

Pascal

   uses calwin32 
    
   Function NWGetObjectName 
     (conn : NWCONN_HANDLE; 
      objID : nuint32; 
      objName : pnstr8; 
      objType : pnuint16 
   ) : NWCCODE; stdcall;
   

Parameters

conn
(IN) Specifies the NetWare server connection handle.
objID
(IN) Specifies the object ID.
objName
(OUT) Points to the object name (minimum buffer size=48).
objType
(OUT) Points to the object type (optional).

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

0x89F1

INVALID_BINDERY_SECURITY

0x89FC

NO_SUCH_OBJECT

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

For NWGetObjectName to be successful, the requesting process must be logged in to the network server and have Read access to the bindery object.

All parameter positions must be filled.

See Object Type.

NCP Calls

See Also

NWChangeObjectSecurity, NWCreateObject, NWGetObjectID