Función SetComputerNameA (sysinfoapi.h)

Artículo
03/05/2024

Establece un nuevo nombre NetBIOS para el equipo local. El nombre se almacena en el Registro y el cambio de nombre surte efecto la próxima vez que el usuario reinicie el equipo.

Si el equipo local es un nodo de un clúster, SetComputerName establece el nombre NetBIOS del equipo local, no el del servidor virtual del clúster.

Para establecer el nombre de host DNS o el nombre de dominio DNS, llame a la función SetComputerNameEx .

Sintaxis

BOOL SetComputerNameA(
  [in] LPCSTR lpComputerName
);

Parámetros

[in] lpComputerName

El nombre del equipo que surtirá efecto la próxima vez que se inicie el equipo. El nombre no debe tener más de MAX_COMPUTERNAME_LENGTH caracteres.

El juego de caracteres estándar incluye letras, números y los símbolos siguientes: ! @ # $ % ^ & ' ) ( . - _ { } ~ . Si este parámetro contiene uno o varios caracteres que están fuera del juego de caracteres estándar, SetComputerName devuelve ERROR_INVALID_PARAMETER.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Las aplicaciones que usan esta función deben tener derechos de administrador.

Nota

El encabezado sysinfoapi.h define SetComputerName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sysinfoapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll