ldap_add_ext_s函式 (winldap.h)

發行項
03/04/2024

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 結構的指標數位列。每個結構都會指定單一屬性。如需詳細資訊，請參閱＜備註＞一節。

[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
程式庫	Wldap32.lib
Dll	Wldap32.dll