NWDSDelFilterToken(3nw)


NWDSDelFilterToken -- deletes the most recently added token from a filter expression tree

Synopsis

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

NWDSCCODE N_API NWDSDelFilterToken (pFilter_Cursor_T cur, void (N_FAR N_CDECL * freeVal)(nuint32 syntax, nptr val);

Description

The parameters are as follows:

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
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

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

Syntax IDs (such as SYN_BOOLEAN) are enumerated in NWDSDEFS.H.

Services

Directory

NCP calls

None

References

NWDSAddFilterToken(3nw), NWDSAllocFilter(3nw), NWDSFreeFilter(3nw), NWDSPutFilter(3nw)


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.