NWDSFreeFilter(3nw)
NWDSFreeFilter --
frees the area allocated to a search filter expression tree
Synopsis
#include <nwnet.h>
or
#include <nwdsfilt.h>
void N_API NWDSFreeFilter
(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 expression tree to be freed.
- freeVal
-
(IN) Specifies the function to be used to free nodes in the filter expression tree.
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
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.
Do not call NWDSFreeFilter after calling NWDSPutFilter, even if NWDSPutFilter returns an error.
Services
Directory
NCP calls
None
References
NWDSAddFilterToken(3nw),
NWDSAllocFilter(3nw),
NWDSDelFilterToken(3nw),
NWDSPutFilter(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.