NWGetObjectName(3nw)


NWGetObjectName -- returns the name and object type of a bindery object on the network server

Synopsis

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWGetObjectName (NWCONN_HANDLE conn, nuint32 objID, pnstr8 objName, pnuint16 objType);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

objID
(IN) Specifies the object ID.

objName
(OUT) Points to the object name (maximum length, minimum buffer size = 48).

objType
(OUT) Points to the object type (optional).

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x89F1
INVALID_BINDERY_SECURITY

0x89FC
NO_SUCH_OBJECT

0x89FE
BINDERY_LOCKED

0x89FF
HARDWARE_FAILURE

Notices

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

If objType is not desired in the return, substitute a NULL. However, all parameter positions must be filled.

Services

Bindery

NCP calls

0x2222 23 54
Get Bindery Object Name

References

NWChangeObjectSecurity(3nw), NWCreateObject(3nw), NWGetObjectID(3nw)


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.