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

Статья
11/20/2024

Преобразует имя объекта службы каталогов из одного формата в другой.

Синтаксис

BOOLEAN SEC_ENTRY TranslateNameA(
  [in]      LPCSTR               lpAccountName,
  [in]      EXTENDED_NAME_FORMAT AccountNameFormat,
  [in]      EXTENDED_NAME_FORMAT DesiredNameFormat,
  [out]     LPSTR                lpTranslatedName,
  [in, out] PULONG               nSize
);

Параметры

[in] lpAccountName

Имя для перевода.

[in] AccountNameFormat

Формат преобразованного имени. Этот параметр является значением из типа перечисления EXTENDED_NAME_FORMAT.

[in] DesiredNameFormat

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

[out] lpTranslatedName

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

[in, out] nSize

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

Если lpTranslated NULL и nSize равно 0, функция завершается успешно и nSize получает необходимый размер буфера.

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

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

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

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

Замечания

TranslateName завершается ошибкой, если он не может привязаться к Active Directory на контроллере домена.

Заметка

Заголовок secext.h определяет TranslateName как псевдоним, который автоматически выбирает версию 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)

См. также

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

DsCrackNames

EXTENDED_NAME_FORMAT

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

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