20.24. slapi_get_next_backend()

Description

This function returns a pointer to the next backend. If you wish to iterate through all of the backends, use this function in conjunction with slapi_get_first_backend(). For example:

				Slapi_Backend *be = NULL;
				char *cookie = NULL;
				be = slapi_get_first_backend (&cookie);
				while (be )
				{
				...
				be = slapi_get_next_backend (cookie);
				}
				slapi_ch_free ((void**)&cookie);
Syntax

#include "slapi-plugin.h"
Slapi_Backend* slapi_get_next_backend(char *cookie);

Parameters

This function takes the following parameter:

cookie Upon input, contains the index from which the search for the next backend is done. Upon output, contains the index of the returned backend.
Returns

This function returns one of the following values:

  • A pointer to the next backend, if it exists, and updates the cookie parameter.
  • NULL, and cookie is not changed.
Memory Concerns

Free the cookie parameter after the iteration using slapi_ch_free().