ldap_add_ext函式 (winldap.h)

發行項
03/13/2024

ldap_add_ext函式會起始異步新增作業至樹狀結構。加入的專案父系必須存在，否則父系必須空白 (等於根) 的辨別名稱，才能讓新增作業成功。

語法

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

參數

[in] ld

會話句柄。

[in] dn

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

[in] attrs

LDAPMod 結構的指標數位列。每個結構都會指定單一屬性。如需詳細資訊，請參閱＜備註＞一節。

[in] ServerControls

LDAP 伺服器控制件的清單。

[in] ClientControls

用戶端控制件的清單。

[out] MessageNumber

要求的訊息識別碼。

傳回值

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

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

備註

ldap_add_ext的參數和效果包括ldap_add。擴充例程包含其他參數，可支援用戶端和伺服器控件和線程安全性。

在呼叫 ldap_add_ext 之前，請在 LDAPMod 結構中指定其屬性來建立專案。將每個結構的 mod_op 字段設定為 LDAP_MOD_ADD，並根據您的項目設定 mod_type 和 mod_vals 欄位。

如果作業成功， ldap_add_ext 將訊息標識碼傳遞至呼叫端作為參數。使用訊息標識符呼叫ldap_result ，以取得作業的結果。

若要讓結果直接傳回，請使用同步函式 ldap_add_ext_s。

多線程： 對ldap_add_ext 的呼叫是安全線程的。

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

ServerControls 和 ClientControls 是選擇性的，如果未使用，則應該設定為 NULL 。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	winldap.h
程式庫	Wldap32.lib
Dll	Wldap32.dll