NWDSPutAttrName

Stores an attribute name in a request buffer to be used by an eDirectory function.

NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP
Library:Cross-Platform NDS (NET*.*)
Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsbuft.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSPutAttrName  ( 
     NWDSContextHandle   context,  
     pBuf_T              buf,  
     pnstr8              attrName); 
  

Pascal

  uses netwin32 
   
  Function NWDSPutAttrName 
    (context : NWDSContextHandle; 
     buf : pBuf_T; 
     attrName : pnstr8 
  ) : NWDSCCODE;
  

Parameters

context

(IN) Specifies the NDS context for the request.

buf

(IN) Points to the request buffer in which to store the attribute name.

attrName

(IN) Points to the attribute name to store in the request buffer.

Return Values

0x0000 0000

SUCCESSFUL

nonzero value

Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

The maximum size of the attribute name is (MAX_DN_CHARS)+1)*sizeof(character size) where character size is 1 for single-byte characters, and 2 for Unicode characters (Unicode characters are always 16 bits). One character is used for NULL termination.

This function is used for object operations such as reading, searching, comparing, and adding. It is also used for schema operations such as reading class definitions and attribute definitions. For more information on using this function, see the appropriate task in the Tasks chapter.

NCP Calls

See Also

NWDSAddObject, NWDSCompare, NWDSPutAttrVal, NWDSRead, NWDSReadAttrDef, NWDSSearch