Gets all the current values for the properties for this ADSI object from the underlying directory store, refreshing the cached values. Calling this method after changing property values but before calling IADs::SetInfo results in losing those changed values. After this call, the cache reflects the property values in the underlying namespace directory store.
GetInfo is called explicitly to refresh all of the ADSI object's cached properties from the underlying namespace. To refresh specific properties, use GetInfoEx.
An implicit GetInfo is invoked if a Get is performed on a specific property in the property cache an no value is found.
HRESULT IADs::GetInfo(void);
This method supports the standard return values E_FAIL and E_UNEXPECTED, as well as the following:
GetInfo does not affect the objects stored in a container. A call to this method affects the properties of the container, not its contents.
Both GetInfo and SetInfo may require multiple accesses to the underlying directory to load or store the properties in the Active Directory 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.
A caller can obtain a property value from an ADSI object at any time after obtaining a pointer on an interface on the object (e.g., through GetObject or through an ADSI enumeration). The caller need not call GetInfo first. If the property in question has not been previously retrieved, the provider is responsible for retrieving and caching it to satisfy the request.
Windows NT: Use version 4.0 and later.
Windows CE: Unsupported.
Header: Declared in iads.h.
ADSI Property Object, IADs::GetInfoEx, Property Cache