System.Win.ComObj.ProgIDToClassID
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.