NWDSPutAttrVal

Stores an attribute value 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)  NWDSPutAttrVal  ( 
     NWDSContextHandle   context,  
     pBuf_T              buf,  
     nuint32             syntaxID,  
     nptr                attrVal);

Pascal

  uses netwin32 
   
  Function NWDSPutAttrVal 
    (context : NWDSContextHandle; 
     buf : pBuf_T; 
     syntaxID : nuint32; 
     attrVal : nptr 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
buf: (IN) Points to the request buffer being prepared.
syntaxID: (IN) Specifies the data type of the attribute value.
attrVal: (IN) Points to the attribute value to be stored in the request buffer.

Return Values

0x0000 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

The buf parameter points to a Buf_T, which is allocated by NWDSAllocBuf and initialized by NWDSInitBuf.

The name of the attribute to which the value belongs is specified previously by calling either NWDSPutChange or NWDSPutAttrName (depending on the nature of the operation).

The syntaxID parameter tells NWDSPutAttrVal what method to use for converting the attribute value to a machine-transparent form when storing the value in the buffer. Syntax IDs (such as SYN_PATH) are enumerated in NWDSDEFS.H. Syntaxes are described in Attribute Syntax Definitions (NDK: Novell eDirectory Schema Reference).

The attrVal parameter points to the attribute value to be stored in the request buffer. The type of data pointed to by attrVal depends on the indicated attribute syntax. See Attribute Syntax Definitions to determine the data type associated with an attribute.

NCP Calls

None