Slapi_Get_Next_Suffix() - Netscape DIRECTORY SERVER 7.0 - PLUG-IN Manual

Functions for Managing Backend Operations

slapi_get_next_suffix()

Returns the DN of the next root suffix of the DIT.
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
node
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.
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()
void *node = NULL;
Slapi_DN * suffix = slapi_get_first_suffix (&node, 1);
while (suffix)
Memory Concerns
You should not free the returned pointer.
See Also
slapi_get_first_suffix()
288 Netscape Directory Server Plug-in Programmer's Guide • October 2004
0 checks only for non-private suffixes.
1 checks for both private and non-private suffixes.
Contains the returned valued, which is the DN of the next root
suffix of the DIT.
. For example:
{
...
suffix = slapi_get_next_suffix (&node, 1);
}