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.