NWDSInitBuf(3nw)


NWDSInitBuf -- initializes a buffer for use as an request buffer for a Directory Services function

Synopsis

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

NWDSCCODE N_API NWDSInitBuf (NWDSContextHandle context, nuint32 operation, pBuf_T buf);

Description

The parameters are as follows:

context
(IN) Specifies the Directory context for the request.

operation
(IN) Specifies the Directory operation for which the buffer is being initialized.

buf
(IN) Points to the buffer being initialized.

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

Only request buffers need to be initialized. Result buffers do not require initialization.

First allocate the request buffer by calling NWDSAllocBuf. Then call NWDSInitBuf to initialize the buffer for a particular type of operation.

operation indicates the operation for which the buffer will be used:

Allocation type Related function
3 DSV_READ NWDSExtSyncRead
NWDSListAttrsEffectiveRights
NWDSRead
NWDSReadReferences
4 DSV_COMPARE NWDSCompare
6 DSV_SEARCH NWDSExtSyncList
NWDSExtSyncSearch
NWDSListByClassAndName
NWDSListContainers
NWDSPutFilter
NWDSSearch
7 DSV_ADD_ENTRY NWDSAddObject
9 DSV_MODIFY_ENTRY NWDSModifyObject
12 DSV_READ_ATTR_DEF NWDSReadAttrDef
14 DSV_DEFINE_CLASS NWDSDefineClass
15 DSV_READ_CLASS_DEF NWDSReadClassDef
16 DSV_MODIFY_CLASS_DEF NWDSModifyClassDef
18 DSV_LIST_CONTAINABLE_CLASSES NWDSListContainableClasses
20 DSV_ADD_PARTITION NWDSAddPartition

 
 ------------------------------------------------------------------ 
|   |  Allocation type             |  Related function            | 
|---|------------------------------|------------------------------| 
| 3 |  DSV_READ                    |  NWDSExtSyncRead             | 
|   |                              |  NWDSListAttrsEffectiveRights| 
|   |                              |  NWDSRead                    | 
|   |                              |  NWDSReadReferences          | 
|---|------------------------------|------------------------------| 
| 4 |  DSV_COMPARE                 |  NWDSCompare                 | 
|---|------------------------------|------------------------------| 
| 6 |  DSV_SEARCH                  |  NWDSExtSyncList             | 
|   |                              |  NWDSExtSyncSearch           | 
|   |                              |  NWDSListByClassAndName      | 
|   |                              |  NWDSListContainers          | 
|   |                              |  NWDSPutFilter               | 
|   |                              |  NWDSSearch                  | 
|---|------------------------------|------------------------------| 
| 7 |  DSV_ADD_ENTRY               |  NWDSAddObject               | 
|---|------------------------------|------------------------------| 
| 9 |  DSV_MODIFY_ENTRY            |  NWDSModifyObject            | 
|---|------------------------------|------------------------------| 
| 12|  DSV_READ_ATTR_DEF           |  NWDSReadAttrDef             | 
|---|------------------------------|------------------------------| 
| 14|  DSV_DEFINE_CLASS            |  NWDSDefineClass             | 
|---|------------------------------|------------------------------| 
| 15|  DSV_READ_CLASS_DEF          |  NWDSReadClassDef            | 
|---|------------------------------|------------------------------| 
| 16|  DSV_MODIFY_CLASS_DEF        |  NWDSModifyClassDef          | 
|---|------------------------------|------------------------------| 
| 18|  DSV_LIST_CONTAINABLE_CLASSES|  NWDSListContainableClasses  | 
|---|------------------------------|------------------------------| 
| 20|  DSV_ADD_PARTITION           |  NWDSAddPartition            | 
|---|------------------------------|------------------------------| 

buf is updated to reflect the selected operation.

Services

Directory

NCP calls

None

References

NWDSAllocBuf(3nw), NWDSFreeBuf(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.