ldap_add関数 (winldap.h)

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

構文

WINLDAPAPI ULONG LDAPAPI ldap_add(
  [in] LDAP         *ld,
  [in] PSTR         dn,
  [in] LDAPMod * [] attrs
);

[in] ld

セッションハンドル。

[in] dn

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

[in] attrs

LDAPMod 構造体へのポインターの配列。各構造体は、1 つの属性を指定します。

関数が成功すると、追加操作のメッセージ ID が返されます。

関数が失敗した場合、-1 が返され、 LDAP データ構造のセッションエラーパラメーターが設定されます。エラーデータを取得するには、 LdapGetLastError を使用します。

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

非同期関数として、 ldap_add は操作のメッセージ ID を返します。操作の結果を取得するには、メッセージ ID を使用して ldap_result を呼び出します。非同期追加操作を完了する前に取り消すには、 ldap_abandonを呼び出します。

結果を直接返すには、同期関数 ldap_add_sを使用します。 ldap_add_extまたはldap_add_ext_sを使用して、LDAP 3 サーバーとクライアントコントロールのサポートを有効にします。

マルチスレッド: 関数呼び出しが -1 エラーコードを返すときに LdapGetLastError を使用して実際のセッションエラーコードを取得する場合、ldap_addの呼び出しはスレッドセーフです。

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