NWGetObjectID(3nw)


NWGetObjectID -- looks up an object ID in the bindery on the network server associated with the given connection handle

Synopsis

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

NWCCODE N_API NWGetObjectID (NWCONN_HANDLE conn, pnstr8 objName, nuint16 objType, pnuint32 objID);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

objName
(IN) Points to the name of the object in the search.

objType
(IN) Specifies the bindery type of the object in the search.

objID
(OUT) Points to the found object ID.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x89F0
WILD_CARD_NOT_ALLOWED

0x89F1
INVALID_BINDERY_SECURITY

0x89FC
NO_SUCH_OBJECT

0x89FE
BINDERY_LOCKED

0x89FF
HARDWARE_FAILURE

Notices

Since each network server contains its own bindery, object IDs are not consistent across network servers.

objName and objType must uniquely identify the bindery object and cannot contain wildcard characters.

The requesting process must be logged in to the network server and have Read access to the bindery object for NWGetObjectID to be successful.

Services

Bindery

NCP calls

0x2222 23 53
Get Bindery Object ID

References

NWChangeObjectSecurity(3nw), NWCreateObject(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.