Lädt eine Typelib

Beschreibung

com_load_typelib(string $typelib, bool $case_insensitive = true): bool

Lädt eine Type Library und registriert deren Konstanten in der Engine, als wären sie mittels define() definiert worden.

Es ist zu beachten, dass es effizienter ist, die php.ini-Einstellungen com.typelib-file zum Vorladen und Registrieren der Konstanten zu verwenden, allerdings ist dieser Weg nicht so flexibel.

Wenn com.autoregister-typelib eingeschaltet ist, wird PHP versuchen, automatisch die mit einem COM-Objekt assoziierten Konstanten zu registrieren, wenn das Objekt initialisiert wird. Dies hängt von den Interfaces ab, die das COM-Objekt selbst unterstützt und ist nicht immer möglich.

Parameter-Liste

typelib

typelib kann eine der folgenden Angaben sein:

Der Dateiname der .tlb-Datei oder des ausführbaren Moduls, das die Type Library enthält.
Die GUID der Type Library, gefolgt von der Versionsnummer, z. B. {00000200-0000-0010-8000-00AA006D2EA4},2,0.
Der Name der Bibliothek, z. B. Microsoft OLE DB ActiveX Data Objects 1.0 Library.

PHP wird versuchen, die Type Library in dieser Reihenfolge abzuarbeiten, da der jeweils benötigte Aufwand und die dabei entstehenden "Kosten" mit jedem Punkt stärker steigen. Die Suche nach dem Namen einer Type Library erfolgt mittels physikalischer Iteration durch die Registry, bis ein Treffer gefunden wird.

case_insensitive

Der Parameter case_insensitive verhält sich genau umgekehrt wie der Parameter $case_insensitive der define()-Funktion.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.