ldap_modify 関数は、既存のエントリを変更します。
構文
WINLDAPAPI ULONG LDAPAPI ldap_modifyW(
[in] LDAP *ld,
[in] PWSTR dn,
[in] LDAPModW * [] 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 を使用します。
マルチスレッド: ldap_modify の呼び出しは、LdapGetLastError を使用して、関数呼び出しが -1 エラー コードを返すときに実際のセッション エラー コードを取得する場合、スレッド セーフです。
注 LDAP 2 サーバーに接続する場合、アプリケーションは、他の操作を試行する前に(ldap_bind ルーチンまたは ldap_simple_bind ルーチンのいずれかを呼び出して) バインド操作を実行する必要があります。
手記
winldap.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてldap_modifyを定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| サポートされる最小サーバー | Windows Server 2008 |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winldap.h |
| ライブラリ | Wldap32.lib |
| DLL | Wldap32.dll |
関連項目
LDAPMod を
ディレクトリ エントリ の変更の