com_load_typelib

(PHP 4 >= 4.1.0, PHP 5)

com_load_typelib — Carga una biblioteca de tipos

Descripción

bool com_load_typelib ( string $typelib_name [, bool $case_insensitive = true ] )

Carga una biblioteca de tipos y registra sus constantes en la máquina, como si fueran definidas usando define().

Observe que es más efectivo usar el ajuste de configuración para pre-cargar y registrar las constantes, aunque no es tan flexible.

Si se ha activado , PHP intenrá registrar automáticamente las constantes asociadas con un objeto COM cuando se instancie. Esto depende de las interfaces proporcionadas por el propio objeto COM, y no siempre puede ser posible.

Parámetros

typelib_name

typelib_name puede ser uno de los siguientes:

El nombre de fichero de un fichero .tlb o el módulo ejecutable que contiente la biblioteca de tipos.
El GUID de la biblioteca de tipos, seguido de su número de versión, por ejemplo {00000200-0000-0010-8000-00AA006D2EA4},2,0.
El nombre de la biblioteca de tipos, p.ej. Microsoft OLE DB ActiveX Data Objects 1.0 Library.

PHP intentará resolver la biblioteca de tipos en este orden, mientras que el proceso se hace más costoso a medida que se baja por la lista; buscar la biblioteca de tipos por nombre se trata físicamente enumerando el registro hasta que se encuentre una coincidencia.

case_insensitive

case_insensitive se comporta de la misma manera que el parámetro con el mismo nombre de la función define().

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

com_load

com_isenum

[edit] Last updated: Fri, 03 Feb 2012

add a note User Contributed Notes com_load_typelib

RQuadling at GMail dot com 17-Jun-2008 03:40


Some libraries load other libraries as part of their functionality. For example Crystal Reports Object Factory uses the CreateObject() method to create an instance of a Crystal Design RunTime Application. If you want to use constants defined in the newly loaded library, you will need to manually register the library - even with com.autoregister_typelib set to true.





<?php


echo 'com.autoregister_typelib = ', ini_get('com.autoregister_typelib'), PHP_EOL;





$o_CrObjectFactory = New COM('CrystalReports11.ObjectFactory.1');





$o_CrApplication = $o_CrObjectFactory->CreateObject("CrystalDesignRunTime.Application");





echo 'Will not be defined : ', crOpenReportByDefault, PHP_EOL;





com_load_typelib('CrystalDesignRunTime.Application');





echo 'Will now be defined : ', crOpenReportByDefault, PHP_EOL;


?>





outputs ...





com.autoregister_typelib = 1


Will not be defined :


Notice: Use of undefined constant crOpenReportByDefault - assumed 'crOpenReportByDefault' in C:\refl.php on line 8


crOpenReportByDefault


Will now be defined : 0

03-May-2004 07:18


In case any of you were wondering what com_load_typelib actually DOES, I have found that it loads constants\enums that the COM obeject has defined.  The example below is using the Nero COM object (from Nero Burning rom, version 6+).  The Nero object defines a bunch of constants, but they can not be used as PHP constants unless you use the mentioned function.  So the example below will work just fine:



<?php

$aNero = new COM("Nero.Nero") or die ("Nero didn't load, too bad");

com_load_typelib("Nero.Nero");

$aNero->GetDrives(NERO_MEDIA_CD);

?>



But this one will not, since PHP will return a message saying that the constant is undefined:



<?php

$aNero = new COM("Nero.Nero") or die ("Nero didn't load, too bad");

$aNero->GetDrives(NERO_MEDIA_CD);

?>



This one took me a while to figure out, hope it helps.  



Also, check out http://www.php.net/manual/en/faq.com.php to find out how to get COM events working in PHP.

ojpp at webdevfm dot com 30-Jan-2004 06:33


Hello PHP community, I want to help in a problem I found in this COM built-in function: com_load_typelib(), when I executed it in order to open a COM Server process (for example: Word, Excel, etc.) I was in trouble to release the object from memory, I figured it out, this is the solution:



Change a configuration in the php.ini:



; autoregister constants of a components typlib on com_load()

com.autoregister_typelib = true



When com.autoregister_typelib directive is true, PHP parser manage the COM server type library, I hope it helps.

richard dot quadling at carval dot co dot uk 26-Feb-2003 05:55


<?php

// Some servers may have an auto timeout, so take as long as you want.

set_time_limit(0);



// Show all errors, warnings and notices whilst developing.

error_reporting(E_ALL);



// Used as a placeholder in certain COM functions where no parameter is required.

$empty = new VARIANT();



// Load the appropriate type library.

com_load_typelib('Word.Application');



// Create an object to use.

$word = new COM('word.application') or die('Unable to load Word');

print "Loaded Word, version {$word->Version}\n";



// Open a new document with bookmarks of YourName and YourAge.

$word->Documents->Open('C:/Unfilled.DOC');



// Fill in the information from the form.

$word->Selection->GoTo(wdGoToBookmark,$empty,$empty,'YourName'); // Note use of wdGoToBookmark, from the typelibrary and the use of $empty.

$word->Selection->TypeText($_GET['YourName']);



$word->Selection->GoTo(wdGoToBookmark,$empty,$empty,'YourAge');

$word->Selection->TypeText($_GET['YourAge']);



// Save it, close word and finish.

$word->Documents[1]->SaveAs("C:/{$_GET['YourName']}.doc");

$word->Quit();

$word->Release();

$word = null;

print "Word closed.\n";

?>



The example document is ...



Hello [Bookmark of YourName], you are [Bookmark of YourAge] years old.



and it would be called ...



word.php?YourName=Richard%20Quadling&YourAge=35



Regards,



Richard.

add a note