Networking_DhcpServer_Start関数

ヘッダー: applibs </networking.h #include>

ネットワーク インターフェイスの DHCP サーバーを登録、構成、開始します。 この関数呼び出しで指定された構成は、既存の構成を上書きします。

int Networking_DhcpServer_Start(const char *networkInterfaceName, const Networking_DhcpServerConfig *dhcpServerConfig);

パラメーター

• networkInterfaceName 構成するネットワーク インターフェイスの名前。

• dhcpServerConfig DHCP サーバー構成を表す Networking_DhcpServerConfig 構造体へのポインター。

エラー

エラーが発生した場合は -1 を返し、エラー値に設定します errno 。

• EACCES: アプリケーション マニフェストに DhcpService 機能が含まれていません。

• ENOENT: パラメーターは networkInterfaceName 、存在しないインターフェイスを参照します。

• EPERM: この操作は、ネットワーク インターフェイスでは許可されません。

• EFAULT: パラメーターは networkInterfaceName NULL です。

• EFAULT: パラメーターは dhcpServerConfig NULL です。

• EAGAIN: ネットワーク スタックの準備ができていない。

• EINVAL: 構成構造体に無効なパラメーターがあります。

その他 errno のエラーも指定できます。このようなエラーは決定的ではなく、同じ動作はシステム更新によって保持されない可能性があります。

戻り値

成功の場合は 0、失敗の場合は -1 を返します。この場合 errno はエラー値に設定されます。

発言

この関数の呼び出し時にネットワーク インターフェイスが起動すると、DHCP サーバーがシャットダウン、構成、起動されます。 インターフェイスがダウンしている場合は、インターフェイスが起動したときにサーバーが起動します。

この関数を呼び出す前に、インターフェイスを静的 IP アドレスで構成する必要があります。それ以外の場合は、EPERM エラーが返されます。

アプリケーション マニフェストの要件

アプリケーション マニフェストには、DhcpService 機能が含まれている必要があります。

概念とサンプル

• サンプル: プライベート ネットワーク サービス