ldap_modrdn_sW関数 (winldap.h)
ldap_modrdn_s関数は、LDAP エントリの相対識別名を変更します。
この関数は古く、以前のバージョンの LDAP との下位互換性のために提供されています。 LDAP 3 以降の場合は、 ldap_rename_ext または ldap_rename_ext_s 関数を 使用します。
構文
WINLDAPAPI ULONG LDAPAPI ldap_modrdn_sW(
[in] LDAP *ExternalHandle,
[in] const PWSTR DistinguishedName,
[out] const PWSTR NewDistinguishedName
);
パラメーター
[in] ExternalHandle
セッション ハンドル。
[in] DistinguishedName
変更するエントリの識別名を含む null で終わる文字列へのポインター。
[out] NewDistinguishedName
エントリを指定する新しい相対識別名を含む null で終わる文字列へのポインター。
戻り値
関数が成功した場合、戻り値は LDAP_SUCCESS。
関数が失敗した場合はエラー コードを返します。 詳細については、「 戻り値」を参照してください。
注釈
ldap エントリの名前を変更するには、 ldap_modrdn_s 関数、または非同期に対応 する ldap_modrdn を使用します。 この関数は、LDAP 1 との互換性を提供します。 それ以外の場合は、 ldap_modrdn2 または ldap_modrdn2_sを使用します。
ldap_modrdn関数を使用すると、オブジェクトの識別名の最下位コンポーネントである相対識別名のみを変更できます。 バージョン 3 で有効な LDAP は、より一般的な名前変更アクセスを許可する識別名の変更プロトコル操作を提供します。 この機能は、 ldap_rename_ext または ldap_rename_ext_sを呼び出すことによって使用できます。 これらの関数は、 ldap_modrdn_s 関数ではなく、エントリ名を変更することをお勧めします。
注意
winldap.h ヘッダーは、ldap_modrdn_sをエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |