Saves the current values for the properties for this Active Directory object from the property cache to the underlying directory store. This is analogous to flushing a buffer out to disk.
HRESULT IADs::SetInfo(void);
This method supports the standard return values E_FAIL and E_UNEXPECTED, as well as the following:
SetInfo does affects only the objects that are newly created in a container. It does not affect objects that were already stored in a container. Except for newly created objects, a call to this method affects the properties of the container, not its contents.
At the time of the SetInfo call, if any property cache values have been written with a control code such as ADS_PROPERTY_UPDATE or ADS_PROPERTY_CLEAR, it is at this time that the appropriate requests are passed on to the underlying directory service.
Both GetInfo and SetInfo may require multiple accesses to the underlying directory to load or store the properties in the ADSI object. It is technically possible for a GetInfo or SetInfo operation to be only partially successful. You are expected to complete as much of the requested operation as possible before returning. Active Directory provides several standard error codes to indicate that a request was not completely processed. See ADSI Errors.
Windows NT: Use version 4.0 and later.
Windows CE: Unsupported.
Header: Declared in iads.h.