ldap_modify_ext関数 (winldap.h)
ldap_modify_ext関数は、既存のエントリを変更します。
構文
WINLDAPAPI ULONG LDAPAPI ldap_modify_ext(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] mods,
[in] PLDAPControlA *ServerControls,
[in] PLDAPControlA *ClientControls,
[out] ULONG *MessageNumber
);
パラメーター
[in] ld
セッション ハンドル。
[in] dn
変更するエントリの名前を含む null で終わる文字列へのポインター。
[in] mods
エントリに対して行う変更の null で終わる配列。
[in] ServerControls
LDAP サーバー コントロールの一覧。
[in] ClientControls
クライアント コントロールの一覧
[out] MessageNumber
この結果パラメーターは、呼び出しが成功した場合に要求のメッセージ ID に設定されます。
戻り値
関数が成功した場合、戻り値は LDAP_SUCCESS。
関数が失敗した場合はエラー コードを返します。 詳細については、「 戻り値 」を参照してください。
注釈
ldap_modify_ext関数は、既存のエントリを変更する非同期操作を開始します。 エントリに値を追加または置換する場合、関数は必要に応じて 属性を作成します。 値が削除され、値が残っていない場合、関数は 属性を削除します。 すべての変更は、一覧表示されている順序で実行されます。
ldap_modify_extのパラメーターと効果は、ldap_modifyのパラメーターと効果をサブボリュームに含めます。 拡張ルーチンには、クライアントとサーバーのコントロール、およびスレッド セーフをサポートするための追加のパラメーターが含まれています。
成功した場合、 ldap_modify_ext は MessageNumber パラメーターで操作のメッセージ ID を返します。 メッセージ ID を使用して ldap_result を呼び出して、操作の結果を取得します。 関数から結果を直接返す場合は、同期拡張関数 ldap_modify_ext_sを使用します。
マルチスレッド: ldap_modify_ext への呼び出しはスレッド セーフです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |