Netscape DIRECTORY SERVER 6.2 - PLUG-IN Manual page 276

Functions for Managing Backend Operations
slapi_get_first_suffix()
Returns the first root suffix of the DIT.
Syntax
#include "slapi-plugin.h"
Slapi_DN * slapi_get_first_suffix(void ** node, int show_private);
Parameters
This function takes the following parameter:
node
show_private
Returns
This function returns the DN of the first root suffix.
Description
This function returns the first root suffix of the DIT. If you wish to iterate through
all of the suffixes, use this function in conjunction with
slapi_get_next_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_next_suffix()
slapi_get_next_backend()
Returns a pointer to the next backend.
276 Netscape Directory Server Plug-In Programmer's Guide • December 2003
Contains the returned valued, which is the DN of the first root
suffix of the DIT.
0 checks only for non-private suffixes.
1 checks for both private and non-private suffixes.
{
...
suffix = slapi_get_next_suffix (&node, 1);
}
. For example: