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，並在 LDAP 資料結構中設定會話錯誤參數。若要擷取錯誤資料，請使用 LdapGetLastError。

呼叫 ldap_add之前，請在 LDAPMod 結構中指定其屬性來建立專案。將每個結構的 mod_op 成員設定為LDAP_MOD_ADD，並根據您的專案設定 mod_type 和 mod_vals 成員。

作為非同步函式， ldap_add 傳回作業的訊息識別碼。使用訊息識別碼呼叫ldap_result ，以取得作業的結果。若要在完成之前取消非同步新增作業，請呼叫 ldap_abandon。

若要讓結果直接傳回，請使用同步函式 ldap_add_s。使用 ldap_add_ext 或 ldap_add_ext_s 來啟用 LDAP 3 伺服器和用戶端控制項的支援。

多執行緒：ldap_add 呼叫是安全 執行緒，前提是 LdapGetLastError 用來擷取函式呼叫傳回 -1 失敗碼時的實際會話錯誤碼。

注意連線到 LDAP 2 伺服器時，應用程式必須先呼叫其中一個 ldap_bind 或 ldap_simple_bind 常式，再嘗試其他作業，來執行系結作業。