ICatalogCollection::PopulateByKey method (comadmin.h)

  • Article

Populates a selected list of items in the collection from the COM+ catalog, based on the specified keys.

Syntax

HRESULT PopulateByKey(
  [in] SAFEARRAY *psaKeys
);

Parameters

[in] psaKeys

The Key property value of the objects for which data is to be read.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following values.

Return code Description
S_OK
 The method completed successfully.
COMADMIN_E_OBJECTERRORS
Errors occurred while accessing one or more objects.

Remarks

Call the SaveChanges method prior to calling PopulateByKey if you want to save pending changes. Unsaved changes made to the collection are lost when you call PopulateByKey.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comadmin.h

See also

ICatalogCollection