Функция GetComputerNameExA (sysinfoapi.h)

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

Синтаксис

BOOL GetComputerNameExA(
  [in]      COMPUTER_NAME_FORMAT NameType,
  [out]     LPSTR                lpBuffer,
  [in, out] LPDWORD              nSize
);

Параметры

[in] NameType

Тип извлекаемого имени. Этот параметр является значением из типа перечисления COMPUTER_NAME_FORMAT . В следующей таблице приведены дополнительные сведения.

[out] lpBuffer

Указатель на буфер, который получает имя компьютера или имя виртуального сервера кластера.

Длина имени может превышать MAX_COMPUTERNAME_LENGTH символов, так как DNS допускает более длинные имена. Чтобы убедиться, что буфер достаточно велик, задайте для этого параметра значение NULL и используйте требуемый размер буфера, возвращаемый в параметре lpnSize .

[in, out] nSize

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

Если буфер слишком мал, функция завершается сбоем и GetLastError возвращает ERROR_MORE_DATA. Этот параметр получает требуемый размер буфера, включая завершающий символ NULL .

Если lpBuffer имеет значение NULL, этот параметр должен быть равен нулю.

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

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

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

Комментарии

Если групповая политика не задана для локального компьютера, функция GetComputerNameEx извлекает имена NetBIOS или DNS, установленные при запуске системы. Если задана групповая политика, функция возвращает основное доменное имя, заданное групповой политикой. Изменения имен, внесенные функциями SetComputerName или SetComputerNameEx , не вступают в силу, пока пользователь не перезагрузит компьютер.

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

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

Если вы работаете со средами, в которых используются разные макеты DNS, где полное доменное имя компьютера не соответствует полному доменному имени домена, используйте вместо него LsaQueryInformationPolicy .

Чтобы скомпилировать приложение, использующее эту функцию, определите макрос _WIN32_WINNT как 0x0500 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Примеры

#define _WIN32_WINNT 0x0500

#include <windows.h>
#include <stdio.h>
#include <tchar.h>

void _tmain(void)
{
    TCHAR buffer[256] = TEXT("");
    TCHAR szDescription[8][32] = {TEXT("NetBIOS"), 
        TEXT("DNS hostname"), 
        TEXT("DNS domain"), 
        TEXT("DNS fully-qualified"), 
        TEXT("Physical NetBIOS"), 
        TEXT("Physical DNS hostname"), 
        TEXT("Physical DNS domain"), 
        TEXT("Physical DNS fully-qualified")};
    int cnf = 0;
    DWORD dwSize = _countof(buffer);
    
    for (cnf = 0; cnf < ComputerNameMax; cnf++)
    {
        if (!GetComputerNameEx((COMPUTER_NAME_FORMAT)cnf, buffer, &dwSize))
        {
            _tprintf(TEXT("GetComputerNameEx failed (%d)\n"), GetLastError());
            return;
        }
        else _tprintf(TEXT("%s: %s\n"), szDescription[cnf], buffer);

        dwSize = _countof(buffer);
        ZeroMemory(buffer, dwSize);
    }
}

Требования

См. также

COMPUTER_NAME_FORMAT

Имена компьютеров

GetComputerName

ResUtilGetEnvironmentWithNetName

ResUtilSetResourceServiceEnvironment

ResUtilSetResourceServiceStartParameters

SetComputerName

SetComputerNameEx

Функции сведений о системе