com_load_typelib

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

com_load_typelib — Загрузка Typelib

Описание

com_load_typelib ( string $typelib_name [, bool $case_sensitive = TRUE ] ) : bool

Загружает библиотеку типов и регистрирует ее константы таким образом, как если бы они были определены через define().

Обратите внимание, что гораздо эффективней использовать опцию конфигурации для предзагрузки и регистрации констант. С другой стороны, таком метод менее гибок.

Если включено, то PHP постарается автоматически зарегистрировать константы ассоциированные с объектом COM, когда вы будете создавать его экземпляр. Но подобное поведение зависит от интерфейса объекта COM И может быть недоступно.

Список параметров

typelib_name

typelib_name принимать следующие значения:

  • Имя .tlb-файла или запускаемый модуль, содержащий библиотеку типов.

  • GUID библиотеки типов, после которого указан номер версии, например {00000200-0000-0010-8000-00AA006D2EA4},2,0.

  • Имя библиотеки типов, например Microsoft OLE DB ActiveX Data Objects 1.0 Library.

PHP будет пытаться определить библиотеку в таком порядке. Каждый следующий пункт сильно затратнее по ресурсам чем предыдущий. Т.е. лучше указывать .tbl-файл, если невозможно, то GUID и если совсем все плохо - тогда имя библиотеки. Поиск библиотеки по имени, например, приведет к тому, что будет произведен перебор всех записей регистра.

case_sensitive

case_sensitive ведет себя противоположно параметру $case_insensitive в функции define().

Возвращаемые значения

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.