gethostname 子例程

在线编辑

用途

用于获取本地主机的名称。

库

标准 C 库 (libc.a)

语法

#include <unistd.h>
  
int gethostname ( Name,  NameLength)
char *Name;
size_t NameLength;

描述

gethostname (地理名称) 子例程用于检索本地主机的标准主机名。 如果提供了多余空间，那么返回的 姓名 参数将以 null 结束。 如果提供的空间不足，那么将截断返回的名称以适合给定空间。 系统主机名限制为 256 个字符。

gethostname (地理名称) 子例程允许调用进程确定网络上某个机器的内部主机名。

所有包含 gethostname (地理名称) 子例程的应用程序都必须在将 _BSD 宏设置为特定值的情况下进行编译。 可接受的值为 43 和 44。 此外，所有套接字应用程序都必须包含 BSD libbsd.a 库。

参数

项 描述
名称 指定要将主机名存储在其中的字节数组的地址。
NameLength 指定数组 姓名 的长度。

返回值

在成功完成后，系统将 0 值 0。

如果 gethostname (地理名称) 子例程不成功，那么该子例程处理程序将执行以下功能:

  • 会向调用程序返回-1的值。
  • 将错误代码 (指示特定错误) 移动到 错误号 全局变量中。

错误代码

如果以下情况成立，那么 gethostname (地理名称) 子例程不成功:

错误 描述
Efault Name 参数或 NameLength 参数给出了无效的地址。