com_load_typelib

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

com_load_typelib — Загрузка Typelib

Описание

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

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

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

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

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

typelib

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

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

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

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

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

case_insensitive

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

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

Возвращает true в случае успешного выполнения или false, если возникла ошибка.