php-doc-en/reference/w32api/reference.xml

99 lines
2.4 KiB
XML
Raw Normal View History

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<reference id="ref.w32api">
<title>W32api functions</title>
<titleabbrev>W32api</titleabbrev>
<partintro>
<section id="w32api.intro">
&reftitle.intro;
<para>
This extension is a generic extension api to DLLs. This was originally
written to allow access to the Win32 API from PHP. Although you can also
access other functions exported via other DLLs.
</para>
<para>
Currently supported types are generic PHP types (strings, bools, doubles,
longs and null's) others will be added in the future.
</para>
&warn.experimental;
</section>
&reference.w32api.constants;
<section id="w32api.examples">
&reftitle.examples;
<para>
This example gets the amount of time the system has been running and
displays it in a message box.
</para>
<example>
<title>Get the uptime and display in a message box</title>
<programlisting role="php">
<![CDATA[
<?php
// Define constants needed, taken from
// Visual Studio/Tools/Winapi/WIN32API.txt
define("MB_OK", 0);
dl("php_w32api.dll");
w32api_register_function("kernel32.dll",
"GetTickCount",
"long");
w32api_register_function("User32.dll",
"MessageBoxA",
"long");
$ticks = GetTickCount();
$secs = floor($ticks / 1000);
$mins = floor($secs / 60);
$hours = floor($mins / 60);
$str = sprintf("You have been using your computer for:".
"\r\n %d Milliseconds, or \r\n %d Seconds".
"or \r\n %d mins or\r\n %d hours %d mins.",
$ticks,
$secs,
$mins,
$hours,
$mins - ($hours*60));
MessageBoxA(NULL,
$str,
"Uptime Information",
MB_OK);
?>
]]>
</programlisting>
</example>
</section>
</partintro>
&reference.w32api.functions;
</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
-->