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.