NWDSReadObjectInfo(3nw)
NWDSReadObjectInfo --
returns object information not stored in the object's attributes
Synopsis
#include <nwnet.h>
or
#include <nwdsdsa.h>
NWDSCCODE N_API NWDSReadObjectInfo
(NWDSContextHandle context,
pnstr8 object,
pnstr8 distinguishedName,
pObject_Info_T objectInfo);
Description
The parameters are as follows:
- context
-
(IN) Specifies the Directory context for the request.
- object
-
(IN) Points to the name of the object for which information is to be returned.
- distinguishedName
-
(OUT) Points to the object name.
- objectInfo
-
(OUT) Points to the non-attribute information about the object.
Return values
- 0x0000
-
SUCCESSFUL
- Negative Value
-
Negative values indicate errors. For errors returned by Directory Services,
see ``Directory Services OS Errors'' (-001 to -255), ``Directory Services
Client Library Errors'' (-301 to -399), or ``Directory Services Agent in the
Server Errors'' (-601 to -699).
Notices
Object information can be useful to applications browsing the Directory tree.
objectInfo points to an Object_Info_T structure.
If aliases are to be dereferenced (the context flag associated with
DSV_DEREF_ALIASES is set) and object passes an alias name
for the object, the name pointed to by
distinguishedName
is the dereferenced name of the object.
The caller must allocate memory to hold the distinguished name of the object.
The size of the memory is (MAX_DN_CHARS+1)*sizeof(character size),
where character size is 1 for single-byte characters, and 2 for double-byte
characters (Unicode is double byte). One character is used for NULL
termination.
Services
Directory
NCP calls
- 0x2222 23 17
-
Get File Server Information
- 0x2222 23 22
-
Get Station's Logged Info (old)
- 0x2222 23 28
-
Get Station's Logged Info
- 0x2222 104 01
-
Ping for NDS NCP
- 0x2222 104 02
-
Send NDS Fragmented Request/Reply
References
NWDSRead(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.