Функция GetComputerNameA (winbase.h)

Статья
08/27/2023

Извлекает NetBIOS-имя локального компьютера. Это имя устанавливается при запуске системы, когда система считывает его из реестра.

GetComputerName получает только NetBIOS-имя локального компьютера. Чтобы получить имя узла DNS, доменное имя DNS или полное DNS-имя, вызовите функцию GetComputerNameEx . Дополнительные сведения предоставляются интерфейсом IADsADSystemInfo .

Поведение этой функции может быть затронуто, если локальный компьютер является узлом в кластере. Дополнительные сведения см. в разделах ResUtilGetEnvironmentWithNetName и UseNetworkName.

Синтаксис

BOOL GetComputerNameA(
  [out]     LPSTR   lpBuffer,
  [in, out] LPDWORD nSize
);

Параметры

[out] lpBuffer

Указатель на буфер, получающий имя компьютера или имя виртуального сервера кластера. Размер буфера должен быть достаточно большим, чтобы содержать MAX_COMPUTERNAME_LENGTH + 1 символ.

[in, out] nSize

На входных данных указывает размер буфера в TCHAR. В выходных данных — количество TCHAR , скопированных в буфер назначения, не включая завершающий символ NULL.

Если буфер слишком мал, функция завершается сбоем и GetLastError возвращает ERROR_BUFFER_OVERFLOW. Параметр lpnSize указывает необходимый размер буфера, включая завершающий символ NULL.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Функция GetComputerName извлекает netBIOS-имя, установленное при запуске системы. Изменения имен, внесенные функциями SetComputerName или SetComputerNameEx , не вступают в силу до тех пор, пока пользователь не перезагрузит компьютер.

Если вызывающий объект выполняется в сеансе клиента, эта функция возвращает имя сервера. Чтобы получить имя клиента, используйте функцию WTSQuerySessionInformation .

Примеры

Пример см. в разделе Получение сведений о системе.

Примечание

Заголовок winbase.h определяет GetComputerName как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll