ICOMAdminCatalog2::P romoteUnconfiguredComponents-Methode (comadmin.h)

Artikel
02/24/2024

Höherstufen der angegebenen Klassen von nicht konfigurierten Komponenten zu konfigurierten Komponenten.

Hinweis Vor dem Aufrufen dieser Methode ist es erforderlich, zunächst die nicht konfigurierten Komponenten mithilfe der ImportUnconfiguredComponents-Methode zu importieren. Andernfalls gibt diese Methode einen E_INVALIDARG Fehler zurück.

Syntax

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

Parameter

[in] bstrApplicationIDOrName

Die Anwendungs-ID oder der Name der Anwendung, die die heraufzusteigenden Komponenten enthält.

[in] pVarCLSIDOrProgID

Die nicht konfigurierten Komponenten, die höher gestuft werden sollen. Jedes Element des Variant-Objekts kann eine Zeichenfolge sein, die eine Klassen-ID oder Programm-ID, ein einzelnes Katalogobjekt oder eine Katalogauflistung enthält (z. B. wie von der GetCollectionByQuery2-Methode zurückgegeben).

[in, optional] pVarComponentType

Die Bitnes jeder Komponente. Dieser Parameter kann einen der folgenden Werte annehmen. Wenn dieser Parameter weggelassen wird, wird die native Bitanzahl des Computers angenommen.

Wert	Bedeutung
COMAdmin32BitComponent 0x1	Verwendet ein 32-Bit-Format.
COMAdmin64BitComponent 0x2	Verwendet ein 64-Bit-Format.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL und S_OK zurückgeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	comadmin.h

Weitere Informationen

ICOMAdminCatalog2

Share via