<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.31 Maintainer: tom Status: ready -->
<reference id="ref.com">
 <title>COM Support Funktionen fr Windows</title>
 <titleabbrev>COM</titleabbrev>
  <partintro>
   <simpara>
    Das Component Object Model (COM) ist eine Technologie, welche die
    Wiederverwendung von Code erlaubt, egal in welcher Sprache dieser
    geschrieben wurde. Die Komponenten stellen Schnittstellen bereit,
    welche die verfgbaren Funktionen, aber nicht deren Implementierung
    bekanntgeben (z.B. auf welcher Maschine die Komponente gespeichert
    ist und die Executable, die sie enthlt). Anwendungen knnen ber
    die COM-API beliebige Schnittstellen erzeugen. Man sich das wie einen
    super Remote Procedure Call (RPC) Mechanismus mit einigen grundlegenden
    Objekten vorstellen. Es trennt die Implementation von der Schnittstelle.
   </simpara>
   <simpara>
    COM untersttzt Versioning, die Trennung von Implementation und
    Schnittstelle, sowie das Verstecken von Implementierungsdetails, wie
    z.B. Position der Executable und die Sprache, in welcher die Komponente
    geschrieben wurde.
   </simpara>
   <simpara>
    Die COM Funktionen sind nur in der Windowsversion von PHP verfgbar.
   </simpara>
   <simpara>
    Weitere Informationen zu COM finden Sie in der 
    <ulink url="&url.comspecs;">COM specification</ulink>, oder in Don 
    Box's <ulink url="&url.yacl;"> Yet Another COM Library (YACL)</ulink>.
   </simpara>
  </partintro>
 
 <refentry id="class.com">
  <refnamediv>
   <refname>COM</refname>
   <refpurpose>COM Klasse</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
  <synopsis>$obj = new <classname>COM</classname>("server.object")</synopsis>
  </refsynopsisdiv>
  <refsect1 id="class.com.class">
   <title>Beschreibung</title>
   <simpara>
    Die COM Klasse bietet ein Gerst zur Integration von (D)COM Komponenten
    in Ihre PHP Skripte.
   </simpara>
  </refsect1>
  <refsect1 id="class.com.constructor">
   <title>Methoden</title>
    <methodsynopsis>
     <type>string</type><methodname>COM::COM</methodname>
     <methodparam><type>string</type><parameter>module_name</parameter></methodparam>
     <methodparam choice="opt"><type>string</type><parameter>server_name</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>codepage</parameter></methodparam>
    </methodsynopsis>
   <para>
    COM Klassen Konstruktor. Parameter:
    <variablelist>
    <varlistentry><term>module_name</term>
    <listitem>
     <simpara>
      Name oder Klassen-ID der gewnschten Komponente.
     </simpara>
    </listitem>
    </varlistentry>
    <varlistentry><term>server_name</term>
    <listitem>
     <simpara>
      Name des DCOM Servers, von welchem die Komponente geholt werden soll.
      Ist &null; angegeben, wird <literal>localhost</literal> angenommen.
      Um DCOM zuzulassen, muss <constant>com.allow_dcom</constant>
      in der <filename>php.ini</filename> auf &true; 
      gesetzt sein.
     </simpara>
    </listitem>
    </varlistentry>
    <varlistentry><term>codepage</term>
    <listitem>
     <simpara>
      Spezifiziert die Codepage, welche zur Konvertierung der PHP-Strings in 
      Unicode-Strings und umgekehrt verwendet wird. Mgliche Werte sind 
      <constant>CP_ACP</constant>, <constant>CP_MACCP</constant>,
      <constant>CP_OEMCP</constant>, <constant>CP_SYMBOL</constant>,
      <constant>CP_THREAD_ACP</constant>, <constant>CP_UTF7</constant>
      und <constant>CP_UTF8</constant>.
     </simpara>
    </listitem>
    </varlistentry>
    </variablelist>
   </para>
   <para>
    <example id="example.com1">
     <title>COM Beispiel (1)</title>
     <programlisting role="php">
<![CDATA[
// Word starten
$word = new COM("word.application") or die("Konnte Word nicht instantiieren");
print "Word geladen, Version {$word->Version}\n";

//Fenster anzeigen
$word->Visible = 1;

//ein leeres Dokument ffnen
$word->Documents->Add();

//irgendetwas tun
$word->Selection->TypeText("Dies ist ein Test...");
$word->Documents[1]->SaveAs("Useless test.doc");

//Word schlieen
$word->Quit();

//Das Objekt freigeben
$word->Release();
$word = null;
]]>
     </programlisting>
    </example>
   </para>
   <para>
    <example id="example.com2">
     <title>COM example (2)</title>
     <programlisting role="php">
<![CDATA[
$conn = new COM("ADODB.Connection") or die("Cannot start ADO");
$conn->Open("Provider=SQLOLEDB; Data Source=localhost;
Initial Catalog=database; User ID=user; Password=password");

$rs = $conn->Execute("SELECT * FROM sometable");    // Recordset

$num_columns = $rs->Fields->Count();
echo $num_columns . "\n";

for ($i=0; $i < $num_columns; $i++)
{
    $fld[$i] = $rs->Fields($i);
}

$rowcount = 0;
while (!$rs->EOF)
{
    for ($i=0; $i < $num_columns; $i++)
    {
        echo $fld[$i]->value . "\t";
    }
    echo "\n";
    $rowcount++;            // increments rowcount
    $rs->MoveNext();
}

$rs->Close();
$conn->Close();

$rs->Release();
$conn->Release();

$rs = null;
$conn = null;
]]>
     </programlisting>
    </example>
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="class.variant">
  <refnamediv>
   <refname>VARIANT</refname>
   <refpurpose>VARIANT Klasse</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
  <synopsis>$vVar = new <classname>VARIANT</classname>($var)</synopsis>
  </refsynopsisdiv>
  <refsect1 id="class.variant.class">
   <title>Beschreibung</title>
   <simpara>
    Ein einfacher Container, um Variablen VARIANT Strukturen zu verpacken.
   </simpara>
  </refsect1>
  <refsect1 id="class.variant.constructor">
   <title>Methoden</title>
    <methodsynopsis>
     <type>string</type><methodname>VARIANT::VARIANT</methodname>
     <methodparam choice="opt"><type>mixed</type><parameter>value</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>codepage</parameter></methodparam>
    </methodsynopsis>
   <para>
    VARIANT Klassen-Konstruktor. Parameter:
    <variablelist>
    <varlistentry><term>value</term>
    <listitem>
     <simpara>
      Anfangswert. Ist er nicht angegeben, wird ein VT_EMPTY Objekt erzeugt.
     </simpara>
    </listitem>
    </varlistentry>
    <varlistentry><term>type</term>
    <listitem>
     <simpara>
      spezifiziert den Typ vom Inhalt des VARIANT Objektes. Mgliche Werte sind
      <constant>VT_UI1</constant>, <constant>VT_UI2</constant>, <constant>VT_UI4</constant>, 
      <constant>VT_I1</constant>, <constant>VT_I2</constant>, <constant>VT_I4</constant>, 
      <constant>VT_R4</constant>, <constant>VT_R8</constant>, <constant>VT_INT</constant>, <constant>VT_UINT</constant>,
      <constant>VT_BOOL</constant>, <constant>VT_ERROR</constant>, <constant>VT_CY</constant>, 
      <constant>VT_DATE</constant>, <constant>VT_BSTR</constant>, <constant>VT_DECIMAL</constant>, 
      <constant>VT_UNKNOWN</constant>, <constant>VT_DISPATCH</constant> und <constant>VT_VARIANT</constant>.
      Diese Werte sind wechselseitig exklusiv, knnen aber mit <constant>VT_BYREF</constant>
      vereinigt werden, um zu spezifizieren, dass es sich um einen Wert handelt. 
      Wird er weggelassen, wird der Typ von <parameter>value</parameter> verwendet.
      Konsultieren Sie bitte die MSDN Library fr weitere Informationen.
     </simpara>
    </listitem>
    </varlistentry>
    <varlistentry><term>codepage</term>
    <listitem>
     <simpara>
      gibt die Codepage an, welche zur Konvertierung der PHP-Strings in
      Unicode-Strings und umgekehrt verwendet wird. Mgliche Werte sind 
      <constant>CP_ACP</constant>, <constant>CP_MACCP</constant>,
      <constant>CP_OEMCP</constant>, <constant>CP_SYMBOL</constant>,
      <constant>CP_THREAD_ACP</constant>, <constant>CP_UTF7</constant>
      und <constant>CP_UTF8</constant>.
     </simpara>
    </listitem>
    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="function.com-load">
  <refnamediv>
   <refname>com_load</refname>
   <refpurpose>
    Erstellt eine neue Referenz auf eine COM Komponente
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
     <type>string</type><methodname>com_load</methodname>
     <methodparam><type>string</type><parameter>module name</parameter></methodparam>
     <methodparam choice="opt"><type>string</type><parameter>
      server name
      </parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>
      codepage
      </parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>com_load</function> erstellt eine neue COM Komponente, 
    und gibt eine Referenz darauf zurck. Im Fehlerfall wird 
    &false; zurckgegeben. Mgliche Werte fr 
    <parameter>codepage</parameter> sind
    <constant>CP_ACP</constant>, <constant>CP_MACCP</constant>,
    <constant>CP_OEMCP</constant>, <constant>CP_SYMBOL</constant>,
    <constant>CP_THREAD_ACP</constant>, <constant>CP_UTF7</constant>,
    und <constant>CP_UTF8</constant>.
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="function.com-invoke">
  <refnamediv>
   <refname>com_invoke</refname>
   <refpurpose>
    Ruft eine Methode einer COM Komponente auf
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
     <type>mixed</type><methodname>com_invoke</methodname>
     <methodparam><type>resource</type><parameter>com_object</parameter></methodparam>
     <methodparam><type>string</type><parameter>function_name</parameter></methodparam>
     <methodparam choice="opt"><type>mixed</type><parameter>
      function parameters, ...
      </parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>com_invoke</function> ruft eine Methode des mittels 
    <parameter>com_object</parameter> referenzierten COM Komponente auf.
    Gibt bei Erfolg den Rckgabewert von <parameter>function_name</parameter>,
    oder im Fehlerfall &false; zurck.
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="function.com-propget">
  <refnamediv>
   <refname>com_propget</refname>
   <refpurpose>
    Liefert den Wert der Eigenschaft einer COM Komponente
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
     <type>mixed</type><methodname>com_propget</methodname>
     <methodparam><type>resource</type><parameter>com_object</parameter></methodparam>
     <methodparam><type>string</type><parameter>property</parameter></methodparam>
    </methodsynopsis>
   <para>
    Diese Funktion ist ein Alias von <function>com_get</function>.
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="function.com-get">
  <refnamediv>
   <refname>com_get</refname>
   <refpurpose>
    Liefert den Wert der Eigenschaft einer COM Komponente
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
     <type>mixed</type><methodname>com_get</methodname>
     <methodparam><type>resource</type><parameter>com_object</parameter></methodparam>
     <methodparam><type>string</type><parameter>property</parameter></methodparam>
    </methodsynopsis>
   <para>
    Liefert den Wert der Eigenschaft <parameter>property</parameter> der
    mittels <parameter>com_object</parameter> referenzierten COM Komponente.
    Gibt im Fehlerfall &false; zurck.
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="function.com-propput">
  <refnamediv>
   <refname>com_propput</refname>
   <refpurpose>
    Weist einer Eigenschaft einer COM Komponente einen Wert zu 
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
     <type>void</type><methodname>com_propput</methodname>
     <methodparam><type>resource</type><parameter>com_object</parameter></methodparam>
     <methodparam><type>string</type><parameter>property</parameter></methodparam>
     <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
    </methodsynopsis>
   <para>
    Diese Funktion ist ein Alias fr <function>com_set</function>.
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="function.com-propset">
  <refnamediv>
   <refname>com_propset</refname>
   <refpurpose>
    Weist einer Eigenschaft einer COM Komponente einen Wert zu 
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
     <type>void</type><methodname>com_propset</methodname>
     <methodparam><type>resource</type><parameter>com_object</parameter></methodparam>
     <methodparam><type>string</type><parameter>property</parameter></methodparam>
     <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
    </methodsynopsis>
   <para>
    Diese Funktion ist ein Alias fr <function>com_set</function>.
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="function.com-set">
  <refnamediv>
   <refname>com_set</refname>
   <refpurpose>
    Weist einer Eigenschaft einer COM Komponente einen Wert zu.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
     <type>void</type><methodname>com_set</methodname>
     <methodparam><type>resource</type><parameter>com_object</parameter></methodparam>
     <methodparam><type>string</type><parameter>property</parameter></methodparam>
     <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
    </methodsynopsis>
   <para>
    Setzt den Wert der Eigenschaft <parameter>property</parameter> der COM
    Komponente <parameter>com_object</parameter>. Gibt bei Erfolg den neu gesetzten 
    Wert, oder im Fehlerfall &false; zurck.
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="function.com-addref">
  <refnamediv>
   <refname>com_addref</refname>
   <refpurpose>
    Erhht den Referenzzhler der Komponente
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
      <type>void</type><methodname>com_addref</methodname>
      <void/>
    </methodsynopsis>
   <para>
    Erhht den Referenzzhler der Komponente.
   </para>
  </refsect1>
 </refentry>
 
 <refentry id="function.com-release">
  <refnamediv>
   <refname>com_release</refname>
   <refpurpose>
    Reduziert den Referenzzhler der Komponente
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Beschreibung</title>
    <methodsynopsis>
      <type>void</type><methodname>com_release</methodname>
      <void/>
    </methodsynopsis>
   <para>
    Reduziert den Referenzzhler der Komponente.
   </para>
  </refsect1>
 </refentry>

  <refentry id='function.com-isenum'>
   <refnamediv>
    <refname>com_isenum</refname>
    <refpurpose>Holt eine IEnumVariant</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>void</type><methodname>com_isenum</methodname>
      <methodparam><type>object</type><parameter>com_module</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.com-load-typelib'>
   <refnamediv>
    <refname>com_load_typelib</refname>
    <refpurpose>Ldt eine Typelib</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>void</type><methodname>com_load_typelib</methodname>
      <methodparam><type>string</type><parameter>typelib_name</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>case_insensitive</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

</reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->