NWDSPutAttrVal(3nw)


NWDSPutAttrVal -- stores an attribute value in an request buffer to be used by a Directory Services function

Synopsis

   #include <nwnet.h> 
   or 
   #include <nwdsbuft.h> 
   

NWDSCCODE N_API NWDSPutAttrVal (NWDSContextHandle context, pBuf_T buf, nuint32 syntaxID, nptr attrVal);

Description

The parameters are as follows:

context
(IN) Specifies the Directory 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
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

buf 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).

syntaxID 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 the ``Attribute Syntax Definitions'' chapter of the NetWare Directory Services Schema Specification.

attrVal 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 the ``Attribute Type Definitions'' chapter of the NetWare Directory Services Schema Specification to determine the data type associated with an attribute.

Services

Directory

NCP calls

None

References

NWDSAddObject(3nw), NWDSCompare(3nw), NWDSModifyObject(3nw), NWDSAddPartition(3nw), NWDSPutAttrName(3nw), NWDSPutChange(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.