ldap_add_ext_sW関数 (winldap.h)
ldap_add_ext_s関数は、ツリーへの同期追加操作を開始します。 追加操作を成功させるには、追加されたエントリの親が存在するか、親が空である必要があります (ルートの識別名と同じ)。
構文
WINLDAPAPI ULONG LDAPAPI ldap_add_ext_sW(
[in] LDAP *ld,
[in] const PWSTR dn,
[in] LDAPModW * [] attrs,
[in] PLDAPControlW *ServerControls,
[in] PLDAPControlW *ClientControls
);
パラメーター
[in] ld
セッション ハンドル。
[in] dn
追加するエントリの識別名を含む null で終わる文字列へのポインター。
[in] attrs
LDAPMod 構造体へのポインターの配列。 各構造体は、1 つの属性を指定します。 詳細については、「解説」を参照してください。
[in] ServerControls
LDAP サーバー コントロールの一覧。
[in] ClientControls
クライアント コントロールの一覧。
戻り値
関数が成功すると、 LDAP_SUCCESS が返されます。
関数が失敗した場合は、エラー コードが返されます。 詳細については、「 戻り値」を参照してください。
解説
ldap_add_ext_sのパラメーターと効果には、ldap_add_sのパラメーターと効果が含まれます。 拡張ルーチンには、クライアントとサーバーのコントロールをサポートするための追加のパラメーターが含まれています。
ldap_add_ext_sを呼び出す前に、LDAPMod 構造体でその属性を指定してエントリを作成します。 各構造体の mod_op メンバーを LDAP_MOD_ADDに設定し、エントリに応じて mod_type と mod_vals メンバーを設定します。
追加操作が完了すると、 ldap_add_ext_s は呼び出し元に戻ります。 操作 を 非同期的に完了させる場合は、ldap_add_extを使用します。
マルチスレッド: ldap_add_ext_s の呼び出しはスレッド セーフです。
注意
winldap.h ヘッダーは、ldap_add_ext_sをエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows Vista |
サポートされている最小のサーバー | Windows Server 2008 |
対象プラットフォーム | Windows |
ヘッダー | winldap.h |
Library | Wldap32.lib |
[DLL] | Wldap32.dll |