LDAPControlA 構造体 (winldap.h)

LDAPControl 構造体は、クライアント側コントロールとサーバー コントロールの両方を表します。

構文

typedef struct ldapcontrolA {
  PCHAR         ldctl_oid;
  struct berval ldctl_value;
  BOOLEAN       ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;

メンバーズ

ldctl_oid

"1.2.840.113556.1.4.805" など、コントロールの種類を示す null で終わるワイド文字列へのポインター。

ldctl_value

コントロールに関連付けられているデータ (存在する場合)。 コントロールにデータが関連付けられていない場合は、このメンバーを NULLに設定します。

ldctl_iscritical

コントロールがクリティカルかどうかを示します。このフィールドは Criticality フィールドと呼ばれます。

備考

LDAP 3 を使用すると、制御を使用して LDAP 操作を拡張できます。 サーバー コントロールは、サーバーに送信することも、任意の LDAP メッセージを使用してクライアントに返すことができます。 クライアント コントロールは、クライアント側でのみ LDAP API の動作を拡張し、サーバーに送信されることはありません。 サポートされているコントロールは、オブジェクト識別子 (OID) としてディレクトリ サービス ルートに格納されます。

ldctl_iscritical メンバーを使用すると、サーバーまたはクライアントがコントロールをサポートしていない場合に拡張操作を成功させることができます。 このフィールドの値が 0 の場合、サーバーまたはクライアントはコントロールがサポートされていない場合は無視し、操作を実行します。 値が 0 以外の場合、操作は、サーバーまたはクライアントによってコントロールが認識される場合にのみ実行されます。

詳細と、サポートされている LDAP 拡張コントロールとその説明の一覧については、「拡張コントロールのを参照してください。

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
サポートされる最小サーバー	Windows Server 2008
ヘッダー	winldap.h

関連項目

データ構造

LDAPMessage

コントロール の使用の