Show Table of Contents
20.25. slapi_get_next_suffix()
Description
This function returns the DN of the next root suffix of the DIT. If you wish to iterate through all of the suffixes, use this function in conjunction with slapi_get_first_suffix(). For example:
void *node = NULL;
Slapi_DN * suffix = slapi_get_first_suffix (&node, 1);
while (suffix)
{
...
suffix = slapi_get_next_suffix (&node, 1);
}
Syntax
#include "slapi-plugin.h" Slapi_DN * slapi_get_next_suffix(void ** node, int show_private);
Parameters
This function takes the following parameter:
| show_private | 0 checks only for non-private suffixes.1 checks for both private and non-private suffixes. |
| node | Contains the returned valued, which is the DN of the next root suffix of the DIT. |
Returns
This function returns one of the following values:
- The DN of the next root suffix of the DIT.
- NULL if there are more suffixes to parse.
Memory Concerns
You should not free the returned pointer.
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.