123
edits
Mozilla LDAP SDK Programmer's Guide/LDAP C SDK Function Reference: Difference between revisions
Jump to navigation
Jump to search
Mozilla LDAP SDK Programmer's Guide/LDAP C SDK Function Reference (view source)
Revision as of 12:55, 15 February 2011
, 15 February 2011Typo
(Typo) |
(Typo) |
||
| Line 2,944: | Line 2,944: | ||
<br> The ldap_create_persistentsearch_control() function allows you to perform persistent searches. A ''persistent search'' provides the means to track changes to a set of entries that match the search criteria. After the initial search is performed, the server keeps track of the search criteria and sends back information when any entry that matches the criteria is added, deleted, modified, or renamed. Calling ldap_create_persistentsearch_control() creates an LDAP server control that you can pass to the ldap_search_ext() function. | <br> The ldap_create_persistentsearch_control() function allows you to perform persistent searches. A ''persistent search'' provides the means to track changes to a set of entries that match the search criteria. After the initial search is performed, the server keeps track of the search criteria and sends back information when any entry that matches the criteria is added, deleted, modified, or renamed. Calling ldap_create_persistentsearch_control() creates an LDAP server control that you can pass to the ldap_search_ext() function. | ||
As stated, after you create the control, you can pass it to the LDAP server during a search operation. If you specify that you want | As stated, after you create the control, you can pass it to the LDAP server during a search operation. If you specify that you want entry change notification controls sent back (that is, if you specify a non-zero value for the <tt>return_echg_ctls</tt> parameter), the server includes controls with each changed entry it sends back. To retrieve the controls from each entry, call the ldap_get_entry_controls() function. To get data about the changes made to the entry from the control, call the ldap_parse_entrychange_control() function. When you are done with the search, you can cancel the persistent search by calling the ldap_abandon_ext() function. You should also free the control from memory by calling the ldap_control_free() function. | ||
<br> '''See Also''' | <br> '''See Also''' | ||
<br> ldap_search_ext(), ldap_abandon_ext, ldap_get_entry_controls(), ldap_parse_entrychange_control(), ldap_control_free() | <br> ldap_search_ext(), ldap_abandon_ext, ldap_get_entry_controls(), ldap_parse_entrychange_control(), ldap_control_free() | ||
=== ldap_create_passwordpolicy_control() === | === ldap_create_passwordpolicy_control() === | ||