ldap_modify函式 (winldap.h)

ldap_modify函式會變更現有的專案。

語法

WINLDAPAPI ULONG LDAPAPI ldap_modify(
  [in] LDAP          *ld,
  [in] PSTR          dn,
  [in] LDAPModA * [] mods
);

[in] ld

會話控制碼。

[in] dn

包含要修改之專案名稱之 Null 終止字串的指標。

[in] mods

要對專案進行之修改的 Null 終止陣列。

如果函式成功，它會傳回修改作業的訊息識別碼。

如果函式失敗，它會傳回 –1，並在 LDAP 資料結構中設定會話錯誤參數。

ldap_modify函式會起始非同步作業，以修改現有的專案。如果要在專案中加入或取代值，函式會視需要建立屬性。如果要刪除值，而且沒有保留任何值，則函式會移除屬性。所有修改都會依照列出的循序執行。

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

如果您想要讓函式直接傳回結果，請使用同步常式 ldap_modify_s。如果您需要 LDAP 3 伺服器和用戶端控制項的支援，請使用 ldap_modify_ext 或 ldap_modify_ext_s 。

多執行緒：如果LdapGetLastError用來擷取函式呼叫傳回 -1 失敗碼時，對ldap_modify的呼叫是安全線程。

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