33.38. slapi_mods_get_next_smod()

Description

This function increments the Slapi_Mods iterator and returns the next mod wrapped in a Slapi_Mods. Use this function in conjunction with slapi_mods_get_first_smod() to iterate through the mods in a Slapi_Mods using a Slapi_Mods wrapper.

Syntax

#include "slapi-plugin.h"
Slapi_Mod *slapi_mods_get_next_smod(Slapi_Mods *smods, Slapi_Mod *smod);

Parameters

This function takes the following parameters:

mods
Pointer to an initialized Slapi_Mods.
smod
Pointer to a Slapi_Mods that will be used to hold the mod.
Returns

This function returns a pointer to the Slapi_Mod, wrapping the next mod, or NULL if there are no more mods.

Memory Concerns

Only one thread may be iterating through a particular Slapi_Mods at any given time.