ldap_modrdn2_sA関数 (winldap.h)
ldap_modrdn2_s関数は、LDAP エントリの相対識別名を変更します。
この関数は、現在使用されていません。 LDAP 3 以降の場合は、 ldap_rename_ext または ldap_rename_ext_s関数を 使用します。
構文
WINLDAPAPI ULONG LDAPAPI ldap_modrdn2_sA(
[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 関数を使用すると、オブジェクトの識別名の最下位コンポーネントである相対識別名のみを変更できます。 バージョン 3 で有効な LDAP は、名前変更機能へのアクセスを許可する識別名の変更プロトコル操作を提供します。 この機能は、 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 |
Library | Wldap32.lib |
[DLL] | Wldap32.dll |