Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Руководство пользователя

Страница: 278 / 612

Functions for Managing Backend Operations
278 Netscape Directory Server Plug-In Programmer’s Guide • December 2003
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:
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()
. For example:
void *node = NULL;
Slapi_DN * suffix = slapi_get_first_suffix (&node, 1);
while (suffix)
{
...
suffix = slapi_get_next_suffix (&node, 1);
}
Memory Concerns
You should not free the returned pointer.
See Also
slapi_get_first_suffix()
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.