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

Статья
11/20/2024

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

Синтаксис

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, функция завершается успешно, а параметр lpnS ize получает необходимый размер, или функция завершается ошибкой с ERROR_INSUFFICIENT_BUFFER и lpnSize получает необходимый размер. Поведение зависит от значения NameFormat и версии операционной системы.

[in, out] nSize

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

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

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

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	secext.h (include Security.h)
библиотеки	Secur32.lib
DLL	Secur32.dll
набор API	ext-ms-win-secur32-translatename-l1-1-0 (представлено в Windows 8)

См. также

EXTENDED_NAME_FORMAT

GetComputerNameEx

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

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