Función SetComputerNameA (sysinfoapi.h)
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 conjunto 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 se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Observaciones
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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
sysinfoapi.h (incluya Windows.h) |
| biblioteca de |
Kernel32.lib |
| DLL de |
Kernel32.dll |