NWDSInitBuf

Initializes a buffer for use as a request buffer for 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)  NWDSInitBuf  ( 
     NWDSContextHandle   context,  
     nuint32             operation,  
     pBuf_T              buf); 
  

Pascal

  uses netwin32 
   
  Function NWDSInitBuf 
    (context : NWDSContextHandle; 
     operation : nuint32; 
     buf : pBuf_T 
  ) : NWDSCCODE;
  

Parameters

context

(IN) Specifies the NDS context for the request.

operation

(IN) Specifies the eDirectory operation for which the buffer is being initialized (see Section 5.3, Buffer Operation Types and Related Functions).

buf

(IN) Points to the buffer being initialized.

Return Values

0x0000 0000

SUCCESSFUL

nonzero value

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

Remarks

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.

The buffer pointed to by the buf parameter is updated to reflect the selected operation.

NCP Calls

See Also

NWDSAllocBuf, NWDSFreeBuf