次の方法で共有


ldap_compare_ext_sW関数 (winldap.h)

ldap_compare_ext_s 関数を使用して、特定のエントリの属性が既知の値を保持しているかどうかを判断します。

構文

WINLDAPAPI ULONG LDAPAPI ldap_compare_ext_sW(
  [in] LDAP          *ld,
  [in] const PWSTR   dn,
  [in] const PWSTR   Attr,
  [in] const PWSTR   Value,
  [in] berval        *Data,
  [in] PLDAPControlW *ServerControls,
  [in] PLDAPControlW *ClientControls
);

パラメーター

[in] ld

セッション ハンドル。

[in] dn

比較するエントリの識別名を含む null で終わる文字列へのポインター。

[in] Attr

比較する属性を含む null で終わる文字列へのポインター。

[in] Value

属性値と比較する文字列属性値を含む null で終わる文字列へのポインター。 使用しない場合は、NULL を に設定します。

[in] Data

属性値と比較する ベルバル 属性値。 使用しない場合は、NULL を に設定します。

[in] ServerControls

随意。 LDAP サーバー コントロールの一覧。 使用しない場合は、NULL を に設定します。

[in] ClientControls

随意。 LDAP クライアント コントロールの一覧。 使用しない場合は、NULL を に設定します。

戻り値

関数が成功し、属性と既知の値が一致する場合は、LDAP_COMPARE_TRUE が返されます。値が一致しない場合は、LDAP_COMPARE_FALSE が返されます。

関数が失敗した場合は、エラー コードが返されます。 詳細については、「戻り値を参照してください。

備考

ldap_compare_ext_s 関数は、属性の値を既知の値と比較して、同期比較操作を開始します。 ldap_compare_sのパラメーターと効果 ldap_compare_ext_s サブスメ. 拡張ルーチンには、クライアントとサーバーのコントロールをサポートするための追加のパラメーターと、バイナリ値の比較が含まれています。

文字列値を比較するために Value パラメーターを使用するか、生のバイナリ データを比較するために Data パラメーターを使用します。 未使用のパラメーターを NULL設定します。 どちらのパラメーターも NULLでない場合、比較操作では Data パラメーターの値が使用されます。

マルチスレッド: ldap_compare_ext_s の呼び出しはスレッド セーフです。

手記

winldap.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてldap_compare_ext_sを定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista
サポートされる最小サーバー Windows Server 2008
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winldap.h
ライブラリ Wldap32.lib
DLL Wldap32.dll

関連項目

拡張コントロール を する

Functions

戻り値

コントロール の使用の

ベルベル

ldap_compare_s