NWDSFreeFilter

Frees the area allocated to a search filter expression tree.

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 <nwdsfilt.h> 
   
  N_EXTERN_LIBRARY (void)  NWDSFreeFilter  ( 
     pFilter_Cursor_T   cur,  
     void               (N_FAR N_CDECL  *freeVal)(
                             nuint32   syntax,
                             nptr      val) );

Pascal

  uses netwin32 
   
  Function NWDSFreeFilter 
    (cur : pFilter_Cursor_T; 
     freeVal : FreeValProc 
  );

Parameters

cur: (IN) Points to the filter to be freed, a filter previously allocated with NWDSAllocFilter.
freeVal: (IN) Specifies the function to be used to free nodes in the filter expression tree; can be NULL.

Return Values

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

Remarks

Normally, the expression tree is freed by NWDSPutFilter when the tree is stored in the request buffer. If the tree is not used, it should be freed by calling NWDSFreeFilter.

The function specified by freeVal must accept two parameters.

Do not call NWDSFreeFilter after calling NWDSPutFilter, even if NWDSPutFilter returns an error.

NCP Calls

None