ldap_add_s函式 (winldap.h)

ldap_add_s函式會起始同步新增作業，以將專案新增至樹狀結構。所加入專案的父代必須已經存在，否則父代必須空的 (等於根辨別名稱) ，才能讓新增作業成功。

語法

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

[in] ld

會話控制碼。

[in] dn

Null 終止字串的指標，其中包含要加入之專案的辨別名稱。

[in] attrs

LDAPMod結構的指標以 Null 結束的陣列。每個結構都會指定單一屬性。如需詳細資訊，請參閱「備註」。

如果函式成功，傳回值 會LDAP_SUCCESS。

如果函式失敗，它會傳回錯誤碼。如需詳細資訊，請參閱傳回值。

呼叫 ldap_add_s之前。您必須在 LDAPMod 結構中指定其屬性，以建立專案。將每個結構的 mod_op 成員設定為LDAP_MOD_ADD，並根據您的專案設定 mod_type 和 mod_vals 成員。如需詳細資訊，請參閱修改目錄專案。

完成新增作業時， ldap_add_s 返回呼叫端。如果您想要以非同步方式執行作業，請使用 ldap_add 。

多執行緒： 對ldap_add_s 的呼叫是安全線程的。

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