pcApplicationHostnameHook()

[FreeRTOS-Plus-TCP API 引用]

注意：仅当 FreeRTOSIPConfig.h 文件中的 ipconfigDHCP_REGISTER_HOSTNAME 设置为 1 时，才需要定义钩子。

const char * pcApplicationHostnameHook( void );

eApplicationHostnameHook 是应用程序定义的钩子函数（或回调函数），从 DHCP 服务器请求 IP 地址时，FreeRTOS-Plus-TCP 堆栈会调用该函数。它允许设备将其主机名注册到 DHCP 服务器。

回调函数由应用程序编写器实现，但由 TCP/IP 堆栈调用。回调函数的原型 必须与上面的原型完全匹配（包括函数名称）。应用程序钩子中的代码不应调用正被阻塞的 FreeRTOS-Plus-TCP API 。这样很容易导致死锁。

当应用程序钩子执行时，会借用任务优先级和 IP 任务堆栈。因此，我们建议您保持应用程序钩子的简短性——它可能需要唤醒一些负责执行进一步处理的应用程序任务。

返回值：

设备可以发送到 DHCP 服务器进行注册的以 NULL 结尾的主机名。主机名的最大长度可为 32 个字符。