Share via


CLSIDFromProgIDEx-Funktion (combaseapi.h)

Löst die automatische Installation aus, wenn die COMClassStore-Richtlinie aktiviert ist.

Dies entspricht dem Verhalten von CoCreateInstance , wenn weder CLSCTX_ENABLE_CODE_DOWNLOAD noch CLSCTX_NO_CODE_DOWNLOAD angegeben werden.

Syntax

HRESULT CLSIDFromProgIDEx(
  [in]  LPCOLESTR lpszProgID,
  [out] LPCLSID   lpclsid
);

Parameter

[in] lpszProgID

Ein Zeiger auf die ProgID, deren CLSID angefordert wird.

[out] lpclsid

Empfängt bei der Rückgabe einen Zeiger auf die abgerufene CLSID.

Rückgabewert

Diese Funktion kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Die CLSID wurde erfolgreich abgerufen.
CO_E_CLASSSTRING
Die registrierte CLSID für die ProgID ist ungültig.
REGDB_E_WRITEREGDB
Fehler beim Schreiben der CLSID in die Registrierung. Weitere Informationen finden Sie weiter unten in den Hinweisen.

Hinweise

CLSCTX_ENABLE_CODE_DOWNLOAD ermöglicht die automatische Installation fehlender Klassen über IntelliMirror/Anwendungsverwaltung aus Active Directory. Wenn dieses Flag nicht angegeben ist, bestimmt die COMClassStore-Richtlinie ("Fehlende COM-Komponenten herunterladen") das Verhalten (Standard: kein Download).

Wenn die COMClassStore-Richtlinie die automatische Installation aktiviert, kann CLSCTX_NO_CODE_DOWNLOAD verwendet werden, um den Download für eine Aktivierung explizit zu verbieten.

Wenn einer der folgenden Registrierungswerte aktiviert ist (d. h. auf 1 festgelegt), wird der automatische Download fehlender Klassen aktiviert:

  • HKEY_CURRENT_USER\Software\Policies\Microsoft\Windows\App Management\COMClassStore
  • HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\App Management \COMClassStore

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile combaseapi.h (include Objbase.h)
Bibliothek Ole32.lib
DLL Ole32.dll

Weitere Informationen

ProgIDFromCLSID