LDAPModA 構造体 (winldap.h)
LDAPMod 構造体は、変更操作を実行するために必要なデータを保持します。
構文
typedef struct ldapmodA {
ULONG mod_op;
PCHAR mod_type;
union {
PCHAR *modv_strvals;
berval **modv_bvals;
} mod_vals;
} LDAPModA, *PLDAPModA;
メンバーズ
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
berval ポインターの
備考
変更関数 (ldap_add*、または ldap_modify*) を呼び出す前に、LDAPMod 構造体のフィールドに値を割り当てます。
LDAP_MOD_REPLACE 操作で ldap_modify* は、null ポインターを渡しても属性を削除しません。 ただし、
LDAPMod 構造体を ldap_add* 関数に渡す場合、LDAP_MOD_BVALUES フラグのみが重要です。 新しいオブジェクトを作成することは、値を追加することを意味します。
手記
winldap.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LDAPMod を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| サポートされる最小サーバー | Windows Server 2008 |
| ヘッダー | winldap.h |
関連項目
ディレクトリ エントリ の変更の