Skip to content

Latest commit

 

History

History
139 lines (89 loc) · 4.74 KB

nf-winldap-ldap_add_ext_sa.md

File metadata and controls

139 lines (89 loc) · 4.74 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winldap.ldap_add_ext_sA
ldap_add_ext_sA function (winldap.h)
The ldap_add_ext_s function initiates a synchronous add operation to a tree. For an add operation to succeed, the parent of the entry added must exist, or the parent must be empty (equal to the distinguished name of the root). (ldap_add_ext_sA)
ldap.ldap__add__ext__s
ldap_add_ext_sA
winldap/ldap_add_ext_sA
ldap\ldap_add_ext_s.htm
ldap
b124ad29-2f9a-48c4-b51e-2fc9143a630c
12/05/2018
_ldap_ldap_add_ext_s, ldap.ldap__add__ext__s, ldap.ldap_add_ext_s, ldap_add_ext_s, ldap_add_ext_s function [LDAP], ldap_add_ext_sA, ldap_add_ext_sW, winldap/ldap_add_ext_s, winldap/ldap_add_ext_sA, winldap/ldap_add_ext_sW
winldap.h
Windows
Windows Vista
Windows Server 2008
ldap_add_ext_sW (Unicode) and ldap_add_ext_sA (ANSI)
Wldap32.lib
Wldap32.dll
Windows
19H1
ldap_add_ext_sA
winldap/ldap_add_ext_sA
c++
APIRef
kbSyntax
DllExport
Wldap32.dll
ldap_add_ext_s
ldap_add_ext_sA
ldap_add_ext_sW

ldap_add_ext_sA function

-description

The ldap_add_ext_s function initiates a synchronous add operation to a tree. For an add operation to succeed, the parent of the entry added must exist, or the parent must be empty (equal to the distinguished name of the root).

-parameters

-param ld [in]

The session handle.

-param dn [in]

A pointer to a null-terminated string that contains the distinguished name of the entry to add.

-param attrs [in]

An array of pointers to LDAPMod structures. Each structure specifies a single attribute. For more information, see the Remarks section.

-param ServerControls [in]

A list of LDAP server controls.

-param ClientControls [in]

A list of client controls.

-returns

If the function succeeds, LDAP_SUCCESS is returned.

If the function fails, an error code is returned. For more information, see Return Values.

-remarks

The parameters and effects of ldap_add_ext_s include those of ldap_add_s. The extended routine includes additional parameters to support client and server controls.

Before calling ldap_add_ext_s, create an entry by specifying its attributes in LDAPMod structures. Set the mod_op member of the each structure to LDAP_MOD_ADD, and set the mod_type and mod_vals members as appropriate for your entry.

Upon completion of the add operation, ldap_add_ext_s returns to the caller. Use ldap_add_ext if you prefer to have the operation completed asynchronously.

Multithreading: Calls to ldap_add_ext_s are thread-safe.

Note  When connecting to an LDAP 2 server, the application must perform a bind operation, by calling one of the ldap_bind or ldap_simple_bind routines, before attempting other operations.
 
ServerControls and ClientControls are optional and should be set to NULL if not used.

-see-also

Extended Controls

Functions

LDAPMod

Return Values

Using Controls

ldap_add_ext

ldap_add_s

ldap_bind

ldap_simple_bind