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