array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.com-load-typelib.php', 1 => 'com_load_typelib', 2 => 'Загрузка Typelib', ), 'up' => array ( 0 => 'ref.com.php', 1 => 'Функции COM', ), 'prev' => array ( 0 => 'function.com-get-active-object.php', 1 => 'com_get_active_object', ), 'next' => array ( 0 => 'function.com-message-pump.php', 1 => 'com_message_pump', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/com/functions/com-load-typelib.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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, если возникла ошибка.