Edit

Share via

ICOMAdminCatalog2::PromoteUnconfiguredComponents method (comadmin.h)

  • Article

Promotes the specified classes from unconfigured components to configured components.

Note  Before calling this method, its necessary to first import the unconfigured components by using the ImportUnconfiguredComponents method. Otherwise, this method returns an E_INVALIDARG error.
 

Syntax

HRESULT PromoteUnconfiguredComponents(
  [in]           BSTR    bstrApplicationIDOrName,
  [in]           VARIANT *pVarCLSIDOrProgID,
  [in, optional] VARIANT *pVarComponentType
);

Parameters

[in] bstrApplicationIDOrName

The application ID or name of the application containing the components to be promoted.

[in] pVarCLSIDOrProgID

The unconfigured components to be promoted. Each element of the Variant may be a String containing a class ID or program ID, a single catalog object, or a catalog collection (for example, as returned by the GetCollectionByQuery2 method).

[in, optional] pVarComponentType

The bitnes of each component. This parameter can be one of the following values. If this parameter is omitted, the native bitness of the computer is assumed.

Value Meaning
COMAdmin32BitComponent
0x1
 Uses a 32-bit format.
COMAdmin64BitComponent
0x2
 Uses a 64-bit format.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Requirements

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

See also

ICOMAdminCatalog2