平台 SDK: Windows 系统信息

SetComputerName

SetComputerName函数为本地计算机存储新的NetBIOS名称。 该名称存储在注册表中,并在用户下次重新启动计算机时生效。

如果本地计算机是群集中的节点,SetComputerName将设置本地计算机的NetBIOS名称,而不是群集的名称。

Windows 2000/XP: 要设置DNS主机名或DNS域名,请调用SetComputerNameEx函数。

BOOL SetComputerName(
  LPCTSTR lpComputerName  // 计算机名称
);

参数

  • lpComputerName

  • [in] 指向以空字符结尾的字符串的指针,该字符串指定下次计算机启动时计算机名称的名称。 该名称不得超过MAX_COMPUTERNAME_LENGTH个字符。

    Windows 95/98/Me:  如果此字符串包含标准字符集外部的一个或多个字符,则这些字符将被强制转换为标准字符。

    Windows NT/2000/XP: 如果此字符串包含标准字符集外的一个或多个字符,则SetComputerName将返回ERROR_INVALID_PARAMETER。 它不强制标准集之外的字符。

    标准字符集包括字母,数字和下列符号:! @#$%^&')(。 - _ {}〜。

Windows 95/98/Me: SetComputerNameW由Microsoft层为Unicode支持。 要使用它,必须将某些文件添加到应用程序中,如Windows 95/98 / Me系统上的Microsoft Layer for Unicode所述。

返回值

如果函数成功,则返回值是非零值。

如果函数失败,返回值为零。 要获得扩展的错误信息,请调用GetLastError。

备注

使用此功能的应用程序必须具有管理员权限

要求

  Windows NT/2000/XP: 包含在Windows NT 3.51和更高版本中。

  Windows 95/98/Me: 包含在Windows 95和更高版本中。

  头文件: 声明于 Winbase.h; 包含于  Windows.h.
  库: 使用 Kernel32.lib.
  Unicode: 在Windows NT/2000/XP上作为Unicode和ANSI版本实现。 Microsoft层还支持Unicode。