System.Win.ComObj.ProgIDToClassID

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ProgIDToClassID(const ProgID: string): TGUID;

C++

extern DELPHI_PACKAGE GUID __fastcall ProgIDToClassID(const System::UnicodeString ProgID);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Win.ComObj.pas
System.Win.ComObj.hpp
System.Win.ComObj System.Win.ComObj

Beschreibung

Gibt den Klassenbezeichner (CLSID) zurück, der dem im Parameter ProgID enthaltenen String entspricht.

ProgIDToClassID ermittelt für die angegebene Programm-ID den Klassenbezeichner (CLSID) aus der Registrierdatenbank. Der Parameter ProgID bezeichnet die Programm-ID, für die die CLSID angefordert wird. Es handelt sich dabei um einen String, welcher der CLSID in der Registrierdatenbank zugeordnet ist.

ProgIDToClassID liefert bei Erfolg die angeforderte CLSID zurück. Schlägt die Funktion fehl, wird eine EOleSysError-Exception mit einem Fehlercode ausgelöst, der die Ursache des Fehlers angibt. Folgende Fehlercodes sind möglich:



Fehlercode Bedeutung

CO_E_CLASSSTRING

Die registrierte CLSID für die ProgID ist ungültig.

REGDB_E_WRITEREGDB

Beim Schreiben der CLSID in die Registrierdatenbank ist ein Fehler aufgetreten.



Anmerkung:  Wenn die ProgID in der Registrierdatenbank nicht gefunden werden kann, erzeugt ProgIDToClassID eine OLE 1-CLSID für die ProgID und einen entsprechenden CLSID-Eintrag in der Registrierung.

Siehe auch