Freigeben über


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