ldap_compare_extW関数 (winldap.h)
ldap_compare_ext関数を使用して、特定のエントリの属性が既知の値を保持しているかどうかを判断します。
構文
WINLDAPAPI ULONG LDAPAPI ldap_compare_extW(
[in] LDAP *ld,
[in] const PWSTR dn,
[in] const PWSTR Attr,
[in] const PWSTR Value,
[in] berval *Data,
[in] PLDAPControlW *ServerControls,
[in] PLDAPControlW *ClientControls,
[out] ULONG *MessageNumber
);
パラメーター
[in] ld
セッション ハンドル。
[in] dn
比較するエントリの識別名を含む null で終わる文字列へのポインター。
[in] Attr
比較する属性を含む null で終わる文字列へのポインター。
[in] Value
属性値と比較する文字列属性値を含む null で終わる文字列へのポインター。
[in] Data
属性値と比較する berval 属性値。
[in] ServerControls
省略可能。 LDAP サーバー コントロールの一覧。 このパラメーターは、使用しない場合は NULL に設定する必要があります。
[in] ClientControls
省略可能。 クライアント コントロールの一覧。 このパラメーターは、使用しない場合は NULL に設定する必要があります。
[out] MessageNumber
比較操作のメッセージ ID。
戻り値
関数が成功すると、 LDAP_SUCCESS が返されます。
関数が失敗した場合は、エラー コードが返されます。 詳細については、「 戻り値 」を参照してください。
注釈
ldap_compare_ext関数は、属性の値を既知の値と比較して、非同期比較操作を開始します。 ldap_compareのものをサブスメldap_compare_extのパラメーターと効果。 拡張ルーチンには、クライアントとサーバーの制御、バイナリ値の比較、スレッド セーフをサポートするための追加のパラメーターが含まれています。
文字列値を比較する 場合は Value パラメーターを使用するか、生のバイナリ データを比較する場合は Data パラメーターを使用します。 未使用のパラメーターを NULL に設定 します。 どちらのパラメーターも NULL でない場合、比較操作では Data パラメーターの値が使用されます。
成功した場合、 ldap_compare_ext は MessageNumber パラメーターで操作のメッセージ ID を返します。 メッセージ ID で ldap_result を呼び出して、比較の結果を取得します。 関数が比較結果を直接返すようにするには、同期拡張比較関数 ldap_compare_ext_sを使用します。
マルチスレッド: ldap_compare_ext の呼び出しはスレッド セーフです。
注意
winldap.h ヘッダーは、ldap_compare_extをエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista |
サポートされている最小のサーバー | Windows Server 2008 |
対象プラットフォーム | Windows |
ヘッダー | winldap.h |
Library | Wldap32.lib |
[DLL] | Wldap32.dll |