NWDSDelFilterToken

Deletes the most recently added token from a 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 (NWDSCCODE)  NWDSDelFilterToken  ( 
     pFilter_Cursor_T   cur,  
     void               (N_FAR N_CDECL   *freeVal)(
                                  nuint32   syntax,
                                  nptr      val));
  

Pascal

  uses netwin32 
   
  Function NWDSDelFilterToken 
    (cur : pFilter_Cursor_T; 
     freeVal : FreeValProc 
  ) : NWDSCCODE;
  

Parameters

cur

(IN) Points to the current insertion point in the filter expression tree.

freeVal

(IN) Points to the function to be used to free attribute values.

Return Values

0x0000 0000

SUCCESSFUL

nonzero value

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

Remarks

The freeVal parameter is a pointer to a function freeing the attribute values. The function is passed the syntax ID and the address of the area to free.The freeVal parameter may be NULL, in which case no attribute values are freed.

If NWDSDelFilterToken is successful, cur is updated to reflect the current position in the expression tree (the insertion point of the next token).

For syntax IDs (such as SYN_BOOLEAN), see Section 5.26, Syntax IDs.

NCP Calls

See Also

NWDSAddFilterToken, NWDSAllocFilter, NWDSFreeFilter, NWDSPutFilter