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.