com_load_typelib

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

com_load_typelibCarica una Typelib

Descrizione

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

Carica una type-library e registra le sue costanti nel motore, come se fossero definite usando define().

Nota che è molto più efficiente utilizzare l'impostazione com.typelib-file in php.ini per pre-caricare e registrare le costanti, anche se non è così flessibile.

Se com.autoregister-typelib è attivo, allora PHP tenterà di registrare automaticamente le costanti associate a un oggetto COM quando lo si istanzia. Questo dipende dalle interfacce fornite dall’oggetto COM stesso e potrebbe non essere sempre possibile.

Elenco dei parametri

typelib

typelib può essere uno dei seguenti:

  • Il nome del file di un .tlb o del modulo eseguibile che contiene la type-library.

  • Il GUID della type-library, seguito dal numero di versione, ad esempio {00000200-0000-0010-8000-00AA006D2EA4},2,0.

  • Il nome della type-library, ad esempio Microsoft OLE DB ActiveX Data Objects 1.0 Library.

PHP tenterà di risolvere la type-library in questo ordine, poiché il processo diventa sempre più costoso man mano che si scende nella lista; la ricerca della type-library per nome viene effettuata enumerando fisicamente il registro fino a trovare una corrispondenza.

case_insensitive

Il parametro case_insensitive si comporta inversamente rispetto al parametro $case_insensitive nella funzione define().

Valori restituiti

Restituisce true in caso di successo, false in caso di fallimento.