ldap_compare関数 (winldap.h)
ldap_compare関数を使用して、特定のエントリの属性に既知の値が保持されているかどうかを判断します。
構文
WINLDAPAPI ULONG LDAPAPI ldap_compare(
[in] LDAP *ld,
[in] const PSTR dn,
[in] const PSTR attr,
[in] PSTR value
);
パラメーター
[in] ld
セッション ハンドル。
[in] dn
エントリの識別名を含む null で終わる文字列へのポインター。
[in] attr
比較する属性を含む null で終わる文字列へのポインター。
[in] value
属性値と比較する文字列属性値を含む null で終わる文字列へのポインター。
戻り値
関数が成功すると、比較操作のメッセージ ID が返されます。
関数が失敗した場合、-1 を返し、LDAP 構造体のセッション エラー パラメーターを設定します。 このエラーは、 LdapGetLastError を使用して取得できます。
解説
ldap_compare関数は、属性の値を既知の文字列値と比較して、非同期比較操作を開始します。 バイナリ値を比較するには 、ldap_compare_ext または ldap_compare_ext_s を使用します。 同期比較操作 を 実行するには 、ldap_compare_sまたはldap_compare_ext_s を使用します。
非同期関数として、 ldap_compare は操作のメッセージ ID を返します。 操作 の結果を 取得するには、メッセージ ID を使用して ldap_result を呼び出します。 非同期操作が完了する前に取り消すには、 ldap_abandonを呼び出します。
関数から結果を直接返すには、同期ルーチン ldap_compare_sを使用します。 ldap_compare_extまたはldap_compare_ext_sを使用して、LDAP 3 サーバーおよびクライアント コントロールのサポートを有効にします。
マルチスレッド: 関数呼び出しが -1 エラー コードを返すときに LdapGetLastError を使用して実際のセッション エラー コードを取得する場合、ldap_compareの呼び出しはスレッド セーフです。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | winldap.h |
| Library | Wldap32.lib |
| [DLL] | Wldap32.dll |