Netscape DIRECTORY SERVER 6.1 - PLUG-IN Manual page 438

Functions for Managing RDN
index
type
value
Returns
This function returns one of the following values:
• The real position of the retrieved RDN if the operation was successful.
•
-1
Description
This function gets the type/value pair corresponding to the RDN stored in the next
(index+1) position inside
values is always one unit below its real position in the array.
See Also
slapi_rdn_get_first()
slapi_rdn_get_rdn()
slapi_rdn_get_num_components()
Gets the number of RDN type/value pairs present in a
Syntax
#include "slapi-plugin.h"
int slapi_rdn_get_num_components(Slapi_RDN *rdn);
Parameters
This function takes the following parameter:
rdn
438 Netscape Directory Server Plug-In Programmer's Guide • August 2002
Indicates the position of the RDN the precedes the currently
desired RDN.
Repository that will hold the type (cn, o, ou, etc.) of the next
(index+1) RDN. If this parameter is NULL at the return of the
function, the RDN does not exist.
Repository that will hold the value of the next (index+1) RDN. If
this parameter is NULL, the RDN does not exist.
if there is no RDN in the index position.
rdn
The target Slapi_RDN structure.
. Note that the index of an element within an array of
structure.
Slapi_RDN