<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.net-get-interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<refnamediv>

<refname>net_get_interfaces</refname>

<refpurpose>获取网络接口</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>array</type><type>false</type></type><methodname>net_get_interfaces</methodname>

<void/>

</methodsynopsis>

<para>

返回本地机器上的网络接口（适配器）的列举。

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

&no.function.parameters;

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

返回一个关联 &array;，其中 key 是接口的名称，value 是一个接口属性的关联数组。

&return.falseforfailure;。

</para>

<para>

每个接口关联数组包含：

<table>

<title>接口属性</title>

<tgroup cols="2">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>描述</entry>

<entry>

用于描述接口的可选字符串值。

仅限 Windows。

</entry>

</row>

<row>

<entry>mac</entry>

<entry>

接口的 MAC 地址的可选字符串值。

仅限 Windows。

</entry>

</row>

<row>

<entry>mtu</entry>

<entry>

接口的最大传输单位（MTU）的整数值。

仅限 Windows。

</entry>

</row>

<row>

<entry>unicast</entry>

<entry>

关联数组，见下面的单播属性。

</entry>

</row>

<row>

<entry>up</entry>

<entry>

接口的布尔状态（开/关）。

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

<para>

<table>

<title>单播属性</title>

<tgroup cols="2">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>flags</entry>

<entry>

整数值。

</entry>

</row>

<row>

<entry>family</entry>

<entry>

整数值。

</entry>

</row>

<row>

<entry>address</entry>

<entry>

IPv4 或 IPv6 中的地址的字符串值。

</entry>

</row>

<row>

<entry>netmask</entry>

<entry>

IPv4 或 IPv6 中的网络掩码的字符串值。

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<para>

在获取接口信息失败时会抛出 <constant>E_WARNING</constant>。

</para>

</refsect1>

</refentry>