ldap_modrdn_s函式會變更LDAP項目的相對辨別名稱。
此函式已過時，且已提供給舊版LDAP的回溯相容性。 針對LDAP 3或更新版本，請使用 ldap_rename_ext 或 ldap_rename_ext_s 函式。
語法
WINLDAPAPI ULONG LDAPAPI ldap_modrdn_s(
[in] LDAP *ExternalHandle,
[in] const PSTR DistinguishedName,
[out] const PSTR NewDistinguishedName
);
參數
[in] ExternalHandle
會話句柄。
[in] DistinguishedName
Null 終止字串的指標，其中包含要變更之專案的辨別名稱。
[out] NewDistinguishedName
Null 終止字串的指標，其中包含要提供專案的新相對辨別名稱。
傳回值
如果函式成功，傳回值 會LDAP_SUCCESS。
如果函式失敗，它會傳回錯誤碼。 如需詳細資訊，請參閱 傳回值。
備註
使用 ldap_modrdn_s 函式或其異步對等 專案ldap_modrdn來變更 LDAP 項目的名稱。 此函式提供與LDAP 1的相容性。 否則，請使用 ldap_modrdn2 或 ldap_modrdn2_s。
請注意 ，ldap_modrdn 函式可讓您只變更相對辨別名稱，這是物件辨別名稱最不重要的元件。 LDAP 可透過第 3 版提供修改辨別名稱通訊協定作業，以允許更一般的名稱變更存取。 此功能可透過呼叫 ldap_rename_ext 或 ldap_rename_ext_s取得。 建議使用這些函式，而不是 ldap_modrdn_s 函式，以變更項目名稱。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | winldap.h |
| 程式庫 | Wldap32.lib |
| Dll | Wldap32.dll |