ldap_modify 関数 (winldap.h)

ldap_modify関数は、既存のエントリを変更します。

構文

WINLDAPAPI ULONG LDAPAPI ldap_modify(
  [in] LDAP          *ld,
  [in] PSTR          dn,
  [in] LDAPModA * [] mods
);

[in] ld

セッションハンドル。

[in] dn

変更するエントリの名前を含む null で終わる文字列へのポインター。

[in] mods

エントリに対して行う変更の null で終わる配列。

関数が成功すると、変更操作のメッセージ ID が返されます。

関数が失敗した場合、-1 が返され、 LDAP データ構造のセッションエラーパラメーターが設定されます。

ldap_modify関数は、既存のエントリを変更する非同期操作を開始します。エントリに値を追加または置換する場合、関数は必要に応じて属性を作成します。値が削除され、値が残っていない場合、関数は属性を削除します。すべての変更は、一覧表示された順序で実行されます。

非同期関数として、 ldap_modify は操作のメッセージ ID を返します。メッセージ ID で ldap_result を呼び出して、操作の結果を取得します。非同期操作を完了する前に取り消すには、 ldap_abandonを呼び出します。

関数から結果を直接返す場合は、同期ルーチン ldap_modify_sを使用します。 LDAP 3 サーバーおよびクライアント制御のサポートが必要な場合は、ldap_modify_extまたは ldap_modify_ext_sを使用します。

マルチスレッド: 関数呼び出しが -1 エラーコードを返すときに LdapGetLastError を使用して実際のセッションエラーコードを取得する場合、ldap_modifyの呼び出しはスレッドセーフです。

メモ LDAP 2 サーバーに接続する場合、アプリケーションはバインド操作 ( ldap_bind ルーチンまたは ldap_simple_bind ルーチンのいずれかを呼び出すことによって) を実行してから、他の操作を試行する必要があります。