ldap_modrdn2_s函式會變更LDAP項目的相對辨別名稱。
此函式已過時。 針對LDAP 3或更新版本，請使用 ldap_rename_ext 或 ldap_rename_ext_s 函式。
語法
WINLDAPAPI ULONG LDAPAPI ldap_modrdn2_s(
[in] LDAP *ExternalHandle,
[in] const PSTR DistinguishedName,
[in] const PSTR NewDistinguishedName,
[in] INT DeleteOldRdn
);
參數
[in] ExternalHandle
會話句柄。
[in] DistinguishedName
Null 終止字串的指標，其中包含要變更的辨別名稱。
[in] NewDistinguishedName
Null 終止字串的指標，其中包含要提供專案的新相對辨別名稱。
[in] DeleteOldRdn
如果應該刪除舊的相對辨別名稱，則為TRUE;如果應該保留舊的相對辨別名稱，則為 FALSE。
傳回值
如果函式成功，傳回值會 LDAP_SUCCESS。
如果函式失敗，它會傳回錯誤碼。 如需詳細資訊，請參閱 傳回值。
備註
請注意，各種 ldap_modrdn 函式都可讓您只變更相對辨別名稱，這是物件辨別名稱最不重要的元件。 LDAP 可透過第 3 版提供修改辨別名稱通訊協定作業，以允許存取名稱變更函式。 此功能可透過呼叫 ldap_rename_ext 或 ldap_rename_ext_s 來取得。 建議使用這些函式，而不是 ldap_modrdn2_s 函式來變更項目名稱。
注意 連線到LDAP 2 伺服器時，應用程式必須先呼叫其中一個 ldap_bind 或 ldap_simple_bind 例程來執行系結作業，再嘗試任何其他作業。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | winldap.h |
| 程式庫 | Wldap32.lib |
| Dll | Wldap32.dll |