LDAPModW 構造体 (winldap.h)
LDAPMod 構造体は、変更操作を実行するために必要なデータを保持します。
構文
typedef struct ldapmodW {
ULONG mod_op;
PWCHAR mod_type;
union {
PWCHAR *modv_strvals;
berval **modv_bvals;
} mod_vals;
} LDAPModW, *PLDAPModW;
メンバー
mod_op
実行する変更操作を示す次のいずれかの値を指定します。
ビットごとの OR 演算子を使用して、演算値を LDAP_MOD_BVALUES と組み合わせて、mod_vals共用体がmodv_bvals メンバーを使用することを示すことができます。 LDAP_MOD_BVALUESが設定されていない場合、共用体は modv_strvals メンバーを使用します。
LDAP_MOD_ADD (0x00)
エントリに値を追加します。 指定された値は、 属性の既存の値に追加されます。
LDAP_MOD_DELETE (0x01)
エントリ内の値を削除します。 指定された値は、現在の属性値から削除されます。
LDAP_MOD_REPLACE (0x02)
エントリの値を置き換えます。 指定された値によって、既存の属性値が置き換えられます。
mod_type
変更する属性の名前を指定する null で終わる文字列へのポインター。
mod_vals
値の配列へのポインター (存在する場合) を追加、削除、または置換します。 mop_opに LDAP_MOD_BVALUES フラグが含まれていない場合、modv_strvals メンバーは null で終わる文字列の配列へのポインターです。 mop_opにLDAP_MOD_BVALUESが含まれている場合、modv_bvals メンバーは berval ポインターの配列へのポインターであり、バイナリ値を指定する場合に便利です。
mod_vals.modv_strvals
null で終わる文字列の null で終わる配列へのポインター。 配列の最後の要素は NULL ポインターである必要があります。
mod_vals.modv_bvals
ベルヴァル ポインターの NULL で終わる配列へのポインター。 配列の最後の要素は NULL ポインターである必要があります。
解説
変更関数 (ldap_add*、またはldap_modify*) を呼び出す前に、LDAPMod 構造体のフィールドに値を割り当てます。
LDAP_MOD_REPLACE 操作の ldap_modify * では、null ポインターを渡しても属性は削除されません。 ただし、 mod_vals が NULL に設定されている場合、 LDAP_MOD_DELETE は属性全体を削除 します。
LDAPMod 構造体を ldap_add* 関数に渡す場合、LDAP_MOD_BVALUES フラグのみが重要です。 新しいオブジェクトを作成すると、値が追加されます。
注意
winldap.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LDAPMod を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows Vista |
サポートされている最小のサーバー | Windows Server 2008 |
Header | winldap.h |