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
コントロールがクリティカルかどうかを示します。"重要度" フィールドと呼ばれます。
注釈
LDAP 3 を使用すると、制御を使用して LDAP 操作を拡張できます。 サーバー コントロールは、サーバーに送信することも、LDAP メッセージを使用してクライアントに返することもできます。 クライアント コントロールは、クライアント側でのみ LDAP API の動作を拡張し、サーバーに送信されることはありません。 サポートされているコントロールは、ディレクトリ サービス ルートにオブジェクト識別子 (OID) として格納されます。
ldctl_iscritical メンバーを使用すると、サーバーまたはクライアントがコントロールをサポートしていない場合に拡張操作を成功させることができます。 このフィールドの値が 0 の場合、サーバーまたはクライアントはコントロールがサポートされていない場合は無視し、操作を実行します。 値が 0 以外の場合、コントロールがサーバーまたはクライアントによって認識された場合にのみ操作が実行されます。
詳細と、サポートされている LDAP 拡張コントロールとその説明の一覧については、「 拡張コントロール」を参照してください。
注意
winldap.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LDAPControl を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista |
サポートされている最小のサーバー | Windows Server 2008 |
Header | winldap.h |