<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>W32api 函数</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="函数参考"
HREF="funcref.html"><LINK
REL="PREVIOUS"
TITLE="vpopmail_set_user_quota"
HREF="function.vpopmail-set-user-quota.html"><LINK
REL="NEXT"
TITLE="w32api_deftype"
HREF="function.w32api-deftype.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="reference"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP 手册</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.vpopmail-set-user-quota.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.w32api-deftype.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="reference"
><A
NAME="ref.w32api"
></A
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="title"
>CLXXIII. W32api 函数</H1
><DIV
CLASS="PARTINTRO"
><A
NAME="AEN237996"
></A
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="w32api.intro"
>简介</A
></H1
><P
> 本扩展库是用于连接 DLL 的通用扩展 API。它最初是用来允许从 PHP 中访问
Win32 API，不过也可以访问通过其它 DLL 导出的其它函数。
</P
><P
> 目前支持的有 PHP 的标准类型（string，boolean，float，integer 和 null）以及用
<A
HREF="function.w32api-deftype.html"
><B
CLASS="function"
>w32api_deftype()</B
></A
> 函数所自定义的类型。
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
本扩展已被移动到 <A
HREF="http://pecl.php.net"
TARGET="_top"
>PECL</A
> 库中且自以下版本起不再被绑定到 PHP 中：5.1.0。
</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
BORDER="1"
WIDTH="100%"
><TR
><TD
ALIGN="CENTER"
><B
>警告</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
>本扩展模块是<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>实验性</I
></SPAN
>的。本模块的行为，包括其函数的名称以及其它任何关于此模块的文档可能会在没有通知的情况下随
PHP 以后的发布而改变。使用本扩展模块风险自担。</P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="w32api.requirements"
>需求</A
></H1
><P
> 本扩展只能工作在 Windows 系统中。
</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="w32api.installation"
>安装</A
></H1
><P
>本扩展模块作为 PHP 内核的一部分，无需安装即可使用。</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="w32api.configuration"
>运行时配置</A
></H1
><P
>本扩展模块在 <TT
CLASS="filename"
>php.ini</TT
> 中未定义任何配置选项。</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="w32api.resources"
>资源类型</A
></H1
><P
> 本扩展定义了一种资源类型，用于用户自定义类型。此资源名为
<TT
CLASS="literal"
>"dynaparm"</TT
>。
</P
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="w32api.constants"
>预定义常量</A
></H1
><P
>以下常量由本扩展模块定义，因此只有在本扩展模块被编译到
PHP 中，或者在运行时被动态加载后才有效。</P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><TT
CLASS="constant"
><B
>DC_MICROSOFT</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DC_BORLAND</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DC_CALL_CDECL</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DC_CALL_STD</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DC_RETVAL_MATH4</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DC_RETVAL_MATH8</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DC_CALL_STD_BO</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DC_CALL_STD_MS</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DC_CALL_STD_M8</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
><DT
><TT
CLASS="constant"
><B
>DC_FLAG_ARGPTR</B
></TT
>
(<A
HREF="language.types.integer.html"
><B
CLASS="type"
>integer</B
></A
>)</DT
><DD
><P
>
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="section"
><H1
CLASS="section"
><A
NAME="w32api.examples"
>范例</A
></H1
><P
> 以下例子演示如何得到系统持续运行的时间，并把它显示在一个消息对话框中。
</P
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN238089"
></A
><P
><B
>例 1. 得到系统持续运行的时间，并把它显示在消息对话框中</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB"><?php<br /></font><font color="#FF8000">// 定义所需的常量，来自<br />// Visual Studio/Tools/Winapi/WIN32API.txt<br /></font><font color="#0000BB">define</font><font color="#007700">(</font><font color="#DD0000">"MB_OK"</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// 加载此扩展<br /></font><font color="#0000BB">dl</font><font color="#007700">(</font><font color="#DD0000">"php_w32api.dll"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// 注册 GetTickCount 函数，来自 kernel32.dll<br /></font><font color="#0000BB">w32api_register_function</font><font color="#007700">(</font><font color="#DD0000">"kernel32.dll"</font><font color="#007700">,<br /> </font><font color="#DD0000">"GetTickCount"</font><font color="#007700">,<br /> </font><font color="#DD0000">"long"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// 注册 MessageBoxA 函数，来自 User32.dll<br /></font><font color="#0000BB">w32api_register_function</font><font color="#007700">(</font><font color="#DD0000">"User32.dll"</font><font color="#007700">,<br /> </font><font color="#DD0000">"MessageBoxA"</font><font color="#007700">,<br /> </font><font color="#DD0000">"long"</font><font color="#007700">);<br /><br /></font><font color="#FF8000">// 取得开机时间信息<br /></font><font color="#0000BB">$ticks </font><font color="#007700">= </font><font color="#0000BB">GetTickCount</font><font color="#007700">();<br /><br /></font><font color="#FF8000">// 转换为易于理解的文本<br /></font><font color="#0000BB">$secs </font><font color="#007700">= </font><font color="#0000BB">floor</font><font color="#007700">(</font><font color="#0000BB">$ticks </font><font color="#007700">/ </font><font color="#0000BB">1000</font><font color="#007700">);<br /></font><font color="#0000BB">$mins </font><font color="#007700">= </font><font color="#0000BB">floor</font><font color="#007700">(</font><font color="#0000BB">$secs </font><font color="#007700">/ </font><font color="#0000BB">60</font><font color="#007700">);<br /></font><font color="#0000BB">$hours </font><font color="#007700">= </font><font color="#0000BB">floor</font><font color="#007700">(</font><font color="#0000BB">$mins </font><font color="#007700">/ </font><font color="#0000BB">60</font><font color="#007700">);<br /><br /></font><font color="#0000BB">$str </font><font color="#007700">= </font><font color="#0000BB">sprintf</font><font color="#007700">(</font><font color="#DD0000">"You have been using your computer for:"</font><font color="#007700">.<br /> </font><font color="#DD0000">"\r\n %d Milliseconds, or \r\n %d Seconds"</font><font color="#007700">.<br /> </font><font color="#DD0000">"or \r\n %d mins or\r\n %d hours %d mins."</font><font color="#007700">,<br /> </font><font color="#0000BB">$ticks</font><font color="#007700">,<br /> </font><font color="#0000BB">$secs</font><font color="#007700">,<br /> </font><font color="#0000BB">$mins</font><font color="#007700">,<br /> </font><font color="#0000BB">$hours</font><font color="#007700">,<br /> </font><font color="#0000BB">$mins </font><font color="#007700">- (</font><font color="#0000BB">$hours</font><font color="#007700">*</font><font color="#0000BB">60</font><font color="#007700">));<br /><br /></font><font color="#FF8000">// 显示一个消息对话框，只有一个 OK 按钮和上面的开机时间文本<br /></font><font color="#0000BB">MessageBoxA</font><font color="#007700">(</font><font color="#0000BB">NULL</font><font color="#007700">,<br /> </font><font color="#0000BB">$str</font><font color="#007700">,<br /> </font><font color="#DD0000">"Uptime Information"</font><font color="#007700">,<br /> </font><font color="#0000BB">MB_OK</font><font color="#007700">);<br /></font><font color="#0000BB">?></font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>目录</B
></DT
><DT
><A
HREF="function.w32api-deftype.html"
>w32api_deftype</A
> -- 为 w32api_functions 函数定一个类型</DT
><DT
><A
HREF="function.w32api-init-dtype.html"
>w32api_init_dtype</A
> --
创建了一个数据类型的实例，并且将函数传入的值填入其中
</DT
><DT
><A
HREF="function.w32api-invoke-function.html"
>w32api_invoke_function</A
> -- 带有一个参数的执行一个函数，参数传递在函数名的后面</DT
><DT
><A
HREF="function.w32api-register-function.html"
>w32api_register_function</A
> -- 从函数库中使用 PHP 注册一个函数 function_name</DT
><DT
><A
HREF="function.w32api-set-call-method.html"
>w32api_set_call_method</A
> -- 设置调用的方法</DT
></DL
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.vpopmail-set-user-quota.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>起始页</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.w32api-deftype.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>vpopmail_set_user_quota</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="funcref.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>w32api_deftype</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
