CLSIDFromProgID-Funktion (combaseapi.h)

  • Artikel

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