Función GetComputerNameA (winbase.h)
Recupera el nombre NetBIOS del equipo local. Este nombre se establece al iniciar el sistema, cuando el sistema lo lee del Registro.
GetComputerName recupera solo el nombre NetBIOS del equipo local. Para recuperar el nombre de host DNS, el nombre de dominio DNS o el nombre DNS completo, llame a la función GetComputerNameEx
El comportamiento de esta función puede verse afectado si el equipo local es un nodo de un clúster. Para obtener más información, vea ResUtilGetEnvironmentWithNetName y UseNetworkName.
Sintaxis
BOOL GetComputerNameA(
[out] LPSTR lpBuffer,
[in, out] LPDWORD nSize
);
Parámetros
[out] lpBuffer
Puntero a un búfer que recibe el nombre del equipo o el nombre del servidor virtual del clúster. El tamaño del búfer debe ser lo suficientemente grande como para contener MAX_COMPUTERNAME_LENGTH + 1 caracteres.
[in, out] nSize
En la entrada, especifica el tamaño del búfer, en TCHAR. En la salida, el número de TCHAR de copiado en el búfer de destino, no incluido el carácter nulo de terminación.
Si el búfer es demasiado pequeño, se produce un error en la función y getLastError devuelve ERROR_BUFFER_OVERFLOW. El parámetro lpnSize especifica el tamaño del búfer necesario, incluido el carácter nulo de terminación.
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
La función GetComputerName recupera el nombre NetBIOS establecido en el inicio del sistema. Los cambios de nombre realizados por las funciones SetComputerName o SetComputerNameEx no surten efecto hasta que el usuario reinicie el equipo.
Si el autor de la llamada se ejecuta en una sesión de cliente, esta función devuelve el nombre del servidor. Para recuperar el nombre de cliente, use la función WTSQuerySessionInformation.
Ejemplos
Para obtener un ejemplo, vea Obtener información del sistema.
Nota
El encabezado winbase.h define GetComputerName 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 [aplicaciones de escritorio | Aplicaciones para UWP] |
| servidor mínimo admitido | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winbase.h (incluya Windows.h) |
| biblioteca de |
Kernel32.lib |
| DLL de |
Kernel32.dll |