-10. LDAP Error Codes...............................................14
-11. Performing LDAP Operations.....................................15
-11.1. Initializing an LDAP Session................................15
-11.2. LDAP Session Handle Options.................................16
-11.3. Working With Controls.......................................22
-11.3.1. A Client Control That Governs Referral Processing........23
-11.4. Authenticating to the directory.............................24
-11.5. Closing the session.........................................26
-11.6. Searching...................................................27
-11.7. Reading an Entry............................................31
-
-
-
-Expires: 8 April 2000 [Page 2]
-
-
-C LDAP API C LDAP Application Program Interface 8 October 1999
-
-11.8. Listing the Children of an Entry............................31
-11.9. Comparing a Value Against an Entry..........................31
-11.10. Modifying an entry..........................................33
-11.11. Modifying the Name of an Entry..............................36
-11.12. Adding an entry.............................................38
-11.13. Deleting an entry...........................................40
-11.14. Extended Operations.........................................41
-12. Abandoning An Operation........................................43
-13. Obtaining Results and Peeking Inside LDAP Messages.............43
-14. Handling Errors and Parsing Results............................45
-15. Stepping Through a List of Results.............................48
-16. Parsing Search Results.........................................49
-16.1. Stepping Through a List of Entries or References............49
-16.2. Stepping Through the Attributes of an Entry.................51
-16.3. Retrieving the Values of an Attribute.......................52
-16.4. Retrieving the name of an entry.............................53
-16.5. Retrieving controls from an entry...........................54
-16.6. Parsing References..........................................55
-17. Encoded ASN.1 Value Manipulation...............................56
-17.1. BER Data Structures and Types...............................56
-17.2. Memory Disposal and Utility Functions.......................57
-17.3. Encoding....................................................58
-17.4. Encoding Example............................................61
-17.5. Decoding....................................................62
-17.6. Decoding Example............................................65
-18. Security Considerations........................................67
-19. Acknowledgements...............................................68
-20. Copyright......................................................68
-21. Bibliography...................................................68
-22. Authors' Addresses.............................................69
-23. Appendix A - Sample C LDAP API Code............................70
-24. Appendix B - Namespace Consumed By This Specification..........72
-25. Appendix C - Summary of Requirements for API Extensions........72
-25.1. Compatibility...............................................72
-25.2. Style.......................................................73
-25.3. Dependence on Externally Defined Types......................73
-25.4. Compile Time Information....................................73
-25.5. Runtime Information.........................................73
-25.6. Values Used for Session Handle Options......................73
-26. Appendix D - Known Incompatibilities with RFC 1823.............74
-26.1. Opaque LDAP Structure.......................................74
-26.2. Additional Error Codes......................................74
-26.3. Freeing of String Data with ldap_memfree()..................74
-26.4. Changes to ldap_result()....................................75
-26.5. Changes to ldap_first_attribute() and ldap_next_attribute...75
-26.6. Changes to ldap_modrdn() and ldap_modrdn_s() Functions......75
-26.7. Changes to the berval structure.............................75
-26.8. API Specification Clarified.................................75
-26.9. Deprecated Functions........................................76
-
-
-
-Expires: 8 April 2000 [Page 3]
-
-
-C LDAP API C LDAP Application Program Interface 8 October 1999
-
-27. Appendix E - Data Types and Legacy Implementations.............76
-28. Appendix F - Changes Made Since Last Document Revision.........77
-28.1. API Changes.................................................77
-28.2. Editorial Changes...........................................79
-
+10. Result Codes...................................................14
+11. Performing LDAP Operations.....................................16
+11.1. Initializing an LDAP Session................................16
+11.2. LDAP Session Handle Options.................................17
+11.3. Working With Controls.......................................23
+11.3.1. A Client Control That Governs Referral Processing........24
+11.4. Authenticating to the directory.............................25
+11.5. Closing the session.........................................27
+11.6. Searching...................................................28
+11.7. Reading an Entry............................................32
+
+
+
+Expires: May 2001 [Page 2]
+\f
+C LDAP API C LDAP Application Program Interface 17 November 2000
+
+
+
+11.8. Listing the Children of an Entry............................32
+11.9. Comparing a Value Against an Entry..........................33
+11.10. Modifying an entry..........................................35
+11.11. Modifying the Name of an Entry..............................37
+11.12. Adding an entry.............................................39
+11.13. Deleting an entry...........................................41
+11.14. Extended Operations.........................................43
+12. Abandoning An Operation........................................44
+13. Obtaining Results and Peeking Inside LDAP Messages.............45
+14. Handling Errors and Parsing Results............................47
+15. Stepping Through a List of Results.............................51
+16. Parsing Search Results.........................................51
+16.1. Stepping Through a List of Entries or References............52
+16.2. Stepping Through the Attributes of an Entry.................53
+16.3. Retrieving the Values of an Attribute.......................54
+16.4. Retrieving the name of an entry.............................55
+16.5. Retrieving controls from an entry...........................56
+16.6. Parsing References..........................................57
+17. Encoded ASN.1 Value Manipulation...............................58
+17.1. BER Data Structures and Types...............................58
+17.2. Memory Disposal and Utility Functions.......................60
+17.3. Encoding....................................................60
+17.4. Encoding Example............................................63
+17.5. Decoding....................................................64
+17.6. Decoding Example............................................67
+18. Security Considerations........................................70
+19. Acknowledgements...............................................70
+20. Copyright......................................................70
+21. Bibliography...................................................71
+22. Authors' Addresses.............................................72
+23. Appendix A - Sample C LDAP API Code............................73
+24. Appendix B - Namespace Consumed By This Specification..........74
+25. Appendix C - Summary of Requirements for API Extensions........75
+25.1. Compatibility...............................................75
+25.2. Style.......................................................75
+25.3. Dependence on Externally Defined Types......................75
+25.4. Compile Time Information....................................76
+25.5. Runtime Information.........................................76
+25.6. Values Used for Session Handle Options......................76
+26. Appendix D - Known Incompatibilities with RFC 1823.............76
+26.1. Opaque LDAP Structure.......................................76
+26.2. Additional Result Codes.....................................77
+26.3. Freeing of String Data with ldap_memfree()..................77
+26.4. Changes to ldap_result()....................................77
+26.5. Changes to ldap_first_attribute() and ldap_next_attribute...77
+26.6. Changes to ldap_modrdn() and ldap_modrdn_s() Functions......78
+26.7. Changes to the berval structure.............................78
+26.8. API Specification Clarified.................................78
+
+
+Expires: May 2001 [Page 3]
+\f
+C LDAP API C LDAP Application Program Interface 17 November 2000
+
+
+26.9. Deprecated Functions........................................78
+27. Appendix E - Data Types and Legacy Implementations.............79
+28. Appendix F - Changes Made Since Last Document Revision.........80
+28.1. API Changes.................................................80
+28.2. Editorial Changes and Clarifications........................81