ldap_create_vlv_controlA関数 (winldap.h)
ldap_create_vlv_control 関数は、サーバー上に要求制御 (LDAP_CONTROL_VLVREQUEST) を作成するために使用されます。
構文
WINLDAPAPI INT LDAPAPI ldap_create_vlv_controlA(
[in] PLDAP ExternalHandle,
[in] PLDAPVLVInfo VlvInfo,
[in] UCHAR IsCritical,
[out] PLDAPControlA *Control
);
パラメーター
[in] ExternalHandle
ldap_initの呼び出しから取得した LDAP セッション ハンドル。
[in] VlvInfo
LDAPVLVInfo 構造体のアドレス。その内容は、作成されたコントロールの値を構築するために使用されます。
[in] IsCritical
この値が 0 でない場合、作成されたコントロールの重要度は TRUE
[out] Control
結果パラメーターには、この関数によって作成された要求制御 (LDAP_CONTROL_VLVREQUEST) を含む LDAPControl 構造体のアドレスが割り当てられます。
戻り値
ldap_create_vlv_control 関数は、エラーを示すために LDAP エラー コード を返します。成功した場合はLDAP_SUCCESS。
備考
VLV 検索を実行する場合、クライアントはこの関数を使用して、サーバーに送信される検索要求に含めることができる新しい VLV コントロールを作成する必要があります。 サーバーは、クライアントに渡されるこの VLV 検索の contextID を割り当てます。 VLV 検索が完了したら、ldap_control_free を使用して、ldap_create_vlv_controlによって返されるコントロールを解放し、ldap_controls_free して、ldap_parse_resultによって返される VLV 応答コントロールを含むコントロールの配列を解放する必要があります。
詳細およびこの関数のコード例については、LDAP VLVを使用するためのコード例
手記
winldap.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてldap_create_vlv_controlを定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| サポートされる最小サーバー | Windows Server 2008 |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winldap.h |
| ライブラリ | Wldap32.lib |
| DLL | Wldap32.dll |
関連項目
LDAPControl の
LDAPVLVInfo の
LDAP VLV 制御 を使用した検索