IADs::Get

Given the name of a property, IADs::Get Gets its single value in VARIANT structure from the property cache. Finding no value in the cache invokes an implicit IADs::GetInfo. Use IADs::GetEx to retrieve multi-valued properties.

HRESULT IADs::Get(
  BSTR bstrName,    //Name of the property
  VARIANT * pvProp  //Pointer to a location to hold the retrieved 
                    // value.
);
 

Parameter

bstrName

[in] Name of the property as defined in the ADSI Schema Class Object for this object, for example "MyProperty".

pvProp

[out] Pointer to a location to receive the value of the property.

Return Values

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

S_OK

The property value was retrieved successfully.

QuickInfo

  Windows NT: Use version 4.0 and later.
  Windows CE: Unsupported.
  Header: Declared in iads.h.

See Also

IADs::GetEx, IADs::Put, IADs::PutEx, Property Cache