Show Table of Contents
17.7. slapi_search_internal_get_entry()
Description
This function performs an internal search operation to read one entry; that is, it performs a base object search. If an entry named by dn is found, the ret_entry pointer will be set to point to a copy of the entry that contains the attribute values specified by the attrs parameter.
Syntax
#include "slapi-plugin.h" int slapi_search_internal_get_entry( Slapi_DN *dn, char ** attrs, Slapi_Entry **ret_entry , void * component_identity)
Parameters
This function takes the following parameters:
| dn | The DN of the entry to be read. |
| attrs | A NULL terminated array of attribute types to return from entries that match filter. If you specify a NULL, all attributes will be returned. |
| ret_entry | The address of a pointer to receive the entry if it is found. |
| component_identity | A plug-in or component identifier. This value can be obtained from the SLAPI_PLUGIN_IDENTITY field of the parameter block that is passed to your plug-in initialization function. |
Returns
This function returns the LDAP result code for the search operation and the results of slapi_search_internal_get_entry_ext.
Memory Concerns
The returned entry (*ret_entry) should be freed by calling slapi_entry_free().
See Also
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.