Функция GetComputerObjectNameA (secext.h)

Статья
08/25/2023

Извлекает имя локального компьютера в указанном формате.

Синтаксис

BOOLEAN SEC_ENTRY GetComputerObjectNameA(
  [in]      EXTENDED_NAME_FORMAT NameFormat,
  [out]     LPSTR                lpNameBuffer,
  [in, out] PULONG               nSize
);

Параметры

[in] NameFormat

Формат имени. Этот параметр является значением из типа перечисления EXTENDED_NAME_FORMAT . Он не может быть NameUnknown.

[out] lpNameBuffer

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

Если этот параметр имеет значение NULL, либо функция выполняется успешно и параметр lpnSize получает требуемый размер, либо функция завершается сбоем с ERROR_INSUFFICIENT_BUFFER и lpnSize получает требуемый размер. Поведение зависит от значения NameFormat и версии операционной системы.

[in, out] nSize

На входных данных указывает размер буфера lpNameBuffer в TCHAR. При успешном выполнении получает размер имени, скопированного в буфер. Если буфер lpNameBuffer слишком мал для хранения имени, функция завершается ошибкой и lpnSize получает требуемый размер буфера.

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	secext.h (включая Security.h)
Библиотека	Secur32.lib
DLL	Secur32.dll
Набор API	ext-ms-win-secur32-translatename-l1-1-0 (появилось в Windows 8)

См. также раздел

EXTENDED_NAME_FORMAT

GetComputerNameEx

Системные информационные функции

Поделиться через