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

Статья
03/01/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 в TCHAR. В выходных данных переменная возвращает размер возвращаемой строки в TCHAR, включая завершающий символ NULL .

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

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	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)

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

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

DsCrackNames

EXTENDED_NAME_FORMAT

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

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