Compartilhar via


Função TranslateNameW (secext.h)

Converte um nome de objeto de serviço de diretório de um formato para outro.

Sintaxe

BOOLEAN SEC_ENTRY TranslateNameW(
  [in]      LPCWSTR              lpAccountName,
  [in]      EXTENDED_NAME_FORMAT AccountNameFormat,
  [in]      EXTENDED_NAME_FORMAT DesiredNameFormat,
  [out]     LPWSTR               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 a terminação caractere de nulo.

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 manter o nome convertido, a função falhará e nSize receberá o tamanho do buffer necessário.

Valor de retorno

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.

Observações

TranslateName falhará se não puder associar ao Active Directory em um controlador de domínio.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho secext.h (inclua Security.h)
biblioteca Secur32.lib
de DLL Secur32.dll
conjunto de API ext-ms-win-secur32-translatename-l1-1-0 (introduzido no Windows 8)

Consulte também

nomes de computador

DsCrackNames

EXTENDED_NAME_FORMAT

Funções de informações do sistema