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.