ADSIによる属性の変更

属性値を変更するために、ADSI には IADs.Put と IADs.PutEx が用意されています。 これらのメソッドは、クライアント側キャッシュのデータを変更します。 ディレクトリへの変更をコミットするには、IADs.SetInfo メソッドを呼び出す必要があります。

Note

複数の属性変更が IADs.SetInfo の1回の呼び出しでコミットされるとき、いずれか 1 つの属性を変更できない場合、すべての属性は変更されません。 たとえば、sn 属性と givenName 属性を変更し、その後 SetInfo メソッドを呼び出さずにユーザーオブジェクトの telephoneNumber 属性をクリアした場合、SetInfo を呼び出すと変更が入力されます。 1つ以上の変更が許可されていないため実行できない場合、属性に対して行われた一括変更は、SetInfoの呼び出し中に入力されません。

 

IADs.Put メソッドは、属性名とバリアント パラメーターを受け取ります。 このメソッドを使用して、1つの値と複数の値の両方を含む属性を設定します。

IADs.PutEx メソッドは、複数値の属性に対する操作を制御します。 既存の値を追加、削除、更新、およびクリアできます。 IADs.PutEx メソッドは、常に属性値のバリアント配列を想定しています。 ただし、このメソッドを使用して、1つの値を持つ属性を設定することもできます。

IADs.PutEx メソッドは、ADS_PROPERTY_OPERATION_ENUM 列挙体によって指定された操作を使用します。