Функция TranslateNameA (secext.h)
Преобразует имя объекта службы каталогов из одного формата в другой.
Синтаксис
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.
Комментарии
TranslateName завершается ошибкой, если не удается выполнить привязку к Active Directory на контроллере домена.
Примечание
Заголовок 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) |