Netscape NETSCAPE DIRECTORY SERVER 6.2 - GATEWAY CUSTOMIZATION, Manual

Page: 407 / 612

Functions for LDAPMod Manipulation
Chapter 15 Function Reference 407
slapi_mods_get_first_smod()
Initializes a
Slapi_Mods
iterator and returns the first
mod
wrapped in a
Slapi_Mods
structure.
Syntax
#include “slapi-plugin.h”
Slapi_Mod *slapi_mods_get_first_smod(Slapi_Mods *smods,
Slapi_Mod *smod);
Parameters
This function takes the following parameters:
Returns
This function returns one of the following values:
• A pointer to the
Slapi_Mod
, wrapping the first
mod
.
•
NULL
if no
mod
exist.
Description
Use this function in conjunction with
slapi_mods_get_next_smod()
to iterate
through the mods in a
Slapi_Mods
using a
Slapi_Mods
wrapper.
Memory Concerns
Only one thread may be iterating through a particular
Slapi_Mods
at any given
time.
See Also
slapi_mods_get_next_mod()
slapi_mods_get_ldapmods_byref()
Gets a reference to the array of
LDAPMod
in a
Slapi_Mods
structure.
Syntax
#include “slapi-plugin.h”
LDAPMod **slapi_mods_get_ldapmods_byref(Slapi_Mods *smods);
smods
A pointer to a an initialized
Slapi_Mods
.
smod
Pointer to a
Slapi_Mods
that will be used to hold the
mod
.