ldap_modify_ext函式 (winldap.h)
ldap_modify_ext函式會變更現有的專案。
語法
WINLDAPAPI ULONG LDAPAPI ldap_modify_ext(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] mods,
[in] PLDAPControlA *ServerControls,
[in] PLDAPControlA *ClientControls,
[out] ULONG *MessageNumber
);
參數
[in] ld
會話句柄。
[in] dn
包含要修改之項目名稱之 Null 終止字串的指標。
[in] mods
要對項目進行之修改的 Null 終止陣列。
[in] ServerControls
LDAP 伺服器控制件的清單。
[in] ClientControls
用戶端控制件的清單
[out] MessageNumber
如果呼叫成功，這個結果參數會設定為要求的訊息標識符。
傳回值
如果函式成功，傳回值會 LDAP_SUCCESS。
如果函式失敗，它會傳回錯誤碼。 如需詳細資訊，請參閱 傳回值 。
備註
ldap_modify_ext函式會起始異步操作，以修改現有的專案。 如果在專案中新增或取代值，函式會視需要建立 屬性。 如果要刪除值，而且沒有保留任何值，則函式會移除 屬性。 所有修改都會依照列出的順序執行。
ldap_modify_ext的參數和效果會細分ldap_modify。 擴充例程包含支援用戶端和伺服器控制項，以及線程安全性的其他參數。
如果成功， ldap_modify_ext 傳回 MessageNumber 參數中作業的訊息識別碼。 使用訊息標識符 呼叫 ldap_result ，以取得作業的結果。 如果您想要讓函式直接傳回結果，請使用同步擴充函式 ldap_modify_ext_s。
多線程： 對ldap_modify_ext 的呼叫是安全線程。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | winldap.h |
| 程式庫 | Wldap32.lib |
| Dll | Wldap32.dll |