Teilen über

Networking_DhcpServer_Start-Funktion

  • Artikel

Header: #include <applibs/networking.h>

Registriert, konfiguriert und startet den DHCP-Server für eine Netzwerkschnittstelle. Die durch diesen Funktionsaufruf angegebene Konfiguration überschreibt die vorhandene Konfiguration.

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

Parameter

  • networkInterfaceName Der Name der zu konfigurierenden Netzwerkschnittstelle.

  • dhcpServerConfig Ein Zeiger auf die Networking_DhcpServerConfig Struktur, die die DHCP-Serverkonfiguration darstellt.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

  • EACCES: Das Anwendungsmanifest enthält die DhcpService-Funktion nicht.

  • ENOENT: Der networkInterfaceName Parameter bezieht sich auf eine Schnittstelle, die nicht vorhanden ist.

  • EPERM: Dieser Vorgang ist auf der Netzwerkschnittstelle nicht zulässig.

  • EFAULT: Der networkInterfaceName Parameter ist NULL.

  • EFAULT: Der dhcpServerConfig Parameter ist NULL.

  • EAGAIN: Der Netzwerkstapel ist nicht bereit.

  • EINVAL: Die Konfigurationsstruktur weist ungültige Parameter auf.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.

Rückgabewert

Gibt 0 für erfolg oder -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Bemerkungen

Wenn die Netzwerkschnittstelle beim Aufruf dieser Funktion aktiviert ist, wird der DHCP-Server heruntergefahren, konfiguriert und gestartet. Wenn die Schnittstelle ausgefallen ist, wird der Server gestartet, wenn die Schnittstelle aktiviert ist.

Die Schnittstelle muss mit einer statischen IP-Adresse konfiguriert werden, bevor diese Funktion aufgerufen wird. Andernfalls wird der EPERM-Fehler zurückgegeben.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die DhcpService-Funktion enthalten.

Konzepte und Beispiele