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

Статья
08/27/2023

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

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

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

Синтаксис

BOOL GetComputerNameW(
  [out]     LPWSTR  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