使用 ADSI 修改屬性

為了修改屬性值，ADSI 會提供 IADs.Put 和 IADs.PutEx 方法。 這些方法會修改用戶端快取上的數據。 必須呼叫 IADs.SetInfo 方法，才能認可目錄的變更。

注意

在對 IADs.SetInfo 的單一呼叫中認可多個屬性變更時，如果無法修改任何單一屬性，則不會修改任何屬性。 例如，如果您修改 sn 和 givenName 屬性，並清除用戶物件的 telephoneNumber 屬性，而不需要任何後續呼叫 SetInfo 方法，則會在呼叫 SetInfo 時輸入變更。 如果不允許一或多個修改，因此無法執行，則不會在呼叫 SetInfo 期間輸入對屬性所做的集體修改。

 

IADs.Put 方法會採用屬性名稱和 variant 參數。 使用這個方法可設定同時包含單一和多個值的屬性。

IADs.PutEx 方法可控制多重值屬性上的作業。 您可以附加、刪除、更新和清除現有的值。 IADs.PutEx 方法一律需要屬性值的變數組。 不過，您也可以使用這個方法來設定具有單一值的屬性。

IADs.PutEx 方法會使用 ADS_PROPERTY_OPERATION_ENUM 列舉所指定的作業。