ldap_add_sA関数 (winldap.h)
ldap_add_s関数は、ツリーにエントリを追加する同期追加操作を開始します。 追加するエントリの親が既に存在している必要があります。または、追加操作を成功させるには、親が空 (ルート識別名と同じ) である必要があります。
構文
WINLDAPAPI ULONG LDAPAPI ldap_add_sA(
[in] LDAP *ld,
[in] PSTR dn,
[in] LDAPModA * [] attrs
);
パラメーター
[in] ld
セッション ハンドル。
[in] dn
追加するエントリの識別名を含む null で終わる文字列へのポインター。
[in] attrs
LDAPMod 構造体へのポインターの null で終わる配列。 各構造体は、1 つの属性を指定します。 詳細については、「解説」を参照してください。
戻り値
関数が成功した場合、戻り値は LDAP_SUCCESS。
関数が失敗した場合はエラー コードを返します。 詳細については、「 戻り値 」を参照してください。
注釈
ldap_add_sを呼び出す前に。 LDAPMod 構造体でその属性を指定して、エントリを作成する必要があります。 各構造体の mod_op メンバーをLDAP_MOD_ADDに設定し、エントリに応じて mod_type メンバーと mod_vals メンバーを設定します。 詳細については、「 ディレクトリ エントリの変更 」を参照してください。
追加操作が完了すると、 ldap_add_s は呼び出し元に戻ります。 操作 を 非同期的に実行する場合は、ldap_addを使用します。
マルチスレッド: ldap_add_s の呼び出しはスレッド セーフです。
メモ LDAP 2 サーバーに接続する場合、アプリケーションはバインド操作 ( ldap_bind ルーチンまたは ldap_simple_bind ルーチンのいずれかを呼び出すことによって) を実行してから、他の操作を試行する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |