CLSIDFromProgID-Funktion (combaseapi.h)

Sucht eine CLSID in der Registrierung, wenn eine ProgID angegeben ist.

Syntax

HRESULT CLSIDFromProgID(
  [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

Bei einer ProgID sucht CLSIDFromProgID die zugeordnete CLSID in der Registrierung. Wenn die ProgID in der Registrierung nicht gefunden werden kann, erstellt CLSIDFromProgID eine OLE 1-CLSID für die ProgID und einen CLSID-Eintrag in der Registrierung. Aufgrund der Einschränkungen für OLE 1 CLSID-Werte sind CLSIDFromProgID und CLSIDFromString die einzigen beiden Funktionen, die zum Generieren einer CLSID für ein OLE 1-Objekt verwendet werden können.

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

CLSIDFromProgIDEx

ProgIDFromCLSID