IADs::GetInfoEx

Gets specific current values for the properties for this Active Directory 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.

GetInfoEx is called explicitly to refresh some of an ADSI object's cached properties from the underlying namespace. To refresh all the properties, use GetInfo.

HRESULT IADs::GetInfoEx(
  VARIANT vProperties,  //Property names
  LONG lReserved  //Reserved for future use.
);

Parameter

vHints: [in] Array of BSTR entries that list the properties to load into the Active Directory property cache. Each property name must match one in this object's schema class definition.
lReserved: [in] Word reserved for future use.

Return Values

This method supports the standard return values E_FAIL and E_UNEXPECTED, as well as the following:

S_OK: The current set of property values for this object have been refreshed.

Remarks

GetInfoEx does not affect the objects stored in a container. A call to this method affects the properties of the container, not its contents.

Notes to Implementers

If vHints is empty and no hints are specified, provide as much smart network access as possible. Both GetInfo, GetInfoEx, 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, GetInfoEx 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.

A caller can obtain a property value from an ADSI object at any time after obtaining the object (e.g., through GetObject or through an ADSI enumeration). The caller need not call GetInfo or GetInfoEx first. If the property in question has not been previously retrieved, the provider is responsible for retrieving and caching it to satisfy the request.

QuickInfo