Netscape DIRECTORY SERVER 6.2 - PLUG-IN Manual page 278

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()
278 Netscape Directory Server Plug-In Programmer's Guide • December 2003
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.
{
...
suffix = slapi_get_next_suffix (&node, 1);
}
. For example: