ldap_add_ext_s関数 (winldap.h)

[アーティクル]
03/08/2023

ldap_add_ext_s関数は、ツリーへの同期追加操作を開始します。追加操作を成功させるには、追加するエントリの親が存在するか、親が空である必要があります (ルートの識別名と等しい)。

構文

WINLDAPAPI ULONG LDAPAPI ldap_add_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] LDAPModA * [] attrs,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

パラメーター

[in] ld

セッションハンドル。

[in] dn

追加するエントリの識別名を含む null で終わる文字列へのポインター。

[in] attrs

LDAPMod 構造体へのポインターの配列。各構造体は、1 つの属性を指定します。詳細については、「解説」を参照してください。

[in] ServerControls

LDAP サーバーコントロールの一覧。

[in] ClientControls

クライアントコントロールの一覧。

戻り値

関数が成功すると、 LDAP_SUCCESS が返されます。

関数が失敗した場合は、エラーコードが返されます。詳細については、「戻り値」を参照してください。

注釈

ldap_add_ext_sのパラメーターと効果には、ldap_add_sのものが含まれます。拡張ルーチンには、クライアントとサーバーのコントロールをサポートするための追加のパラメーターが含まれています。

ldap_add_ext_sを呼び出す前に、LDAPMod 構造体でその属性を指定してエントリを作成します。各構造体の mod_op メンバーを LDAP_MOD_ADDに設定し、エントリに応じて mod_type メンバーと mod_vals メンバーを設定します。

追加操作が完了すると、 ldap_add_ext_s は呼び出し元に戻ります。操作を非同期的に完了する場合は、ldap_add_extを使用します。

マルチスレッド: ldap_add_ext_s の呼び出しはスレッドセーフです。

メモ LDAP 2 サーバーに接続する場合、アプリケーションは、他の操作を試行する前に、 ldap_bind ルーチンまたは ldap_simple_bind ルーチンのいずれかを呼び出してバインド操作を実行する必要があります。

ServerControls と ClientControls は省略可能であり、使用しない場合は NULL に設定する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	winldap.h
Library	Wldap32.lib
[DLL]	Wldap32.dll