Função TranslateNameA (secext.h)
Converte um nome de objeto de serviço de diretório de um formato para outro.
Sintaxe
BOOLEAN SEC_ENTRY TranslateNameA(
[in] LPCSTR lpAccountName,
[in] EXTENDED_NAME_FORMAT AccountNameFormat,
[in] EXTENDED_NAME_FORMAT DesiredNameFormat,
[out] LPSTR lpTranslatedName,
[in, out] PULONG nSize
);
Parâmetros
[in] lpAccountName
O nome a ser traduzido.
[in] AccountNameFormat
O formato do nome a ser traduzido. Esse parâmetro é um valor do tipo de enumeração EXTENDED_NAME_FORMAT.
[in] DesiredNameFormat
O formato do nome convertido. Esse parâmetro é um valor do tipo de enumeração EXTENDED_NAME_FORMAT. Não pode ser NameUnknown.
[out] lpTranslatedName
Um ponteiro para um buffer que recebe o nome convertido.
[in, out] nSize
Na entrada, a variável indica o tamanho do buffer lpTranslatedName , em TCHARs. Na saída, a variável retorna o tamanho da cadeia de caracteres retornada, em TCHARs, incluindo o caractere nulo de terminação.
Se lpTranslated for NULL e nSize for 0, a função terá êxito e nSize receberá o tamanho do buffer necessário.
Se o buffer lpTranslatedName for muito pequeno para conter o nome convertido, a função falhará e nSize receberá o tamanho do buffer necessário.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
TranslateName falhará se não puder associar ao Active Directory em um controlador de domínio.
Observação
O cabeçalho secext.h define TranslateName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | secext.h (inclua Security.h) |
| Biblioteca | Secur32.lib |
| DLL | Secur32.dll |
| Conjunto de APIs | ext-ms-win-secur32-translatename-l1-1-0 (introduzido no Windows 8) |