#include <nwnet.h> or #include <nwdsbuft.h>NWDSCCODE N_API NWDSGetObjectName (NWDSContextHandle context, pBuf_T buf, pnstr8 objectName, pnuint32 attrCount, pObject_Info_T objectInfo);
NWDSGetObjectName should be called once for each object in the buffer. The count of objects whose information is stored in the buffer is determined by calling NWDSGetObjectCount.
buf points to a Buf_T filled in by NWDSList, NWDSRead, or NWDSSearch.
objectName points to the name of the current object in the buffer. The object's name is abbreviated if the context flag associated with DCV_CANONICALIZE_NAMES is set. Types are removed from the name if the flag associated with DCV_TYPELESS_NAMES is set.
You must allocate space for the object's name. The size of the allocated 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.
attrCount points to the number of attributes which follow the object name. The attribute count is always zero for a buffer returned by NWDSList since NWDSList only returns the names of objects. The attribute count will be zero or greater for a buffer returned by NWDSSearch.
objectInfo points to additional information about the object. You must allocate memory to retrieve this information (sizeof(Object_Info_T)).
The complete steps for removing information from a result buffer are shown in the reference listing for NWDSList, NWDSRead, and NWDSSearch.
Directory