Funzione TranslateNameA (secext.h)

  • Articolo

Converte un nome di oggetto del servizio directory da un formato a un altro.

Sintassi

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

Parametri

[in] lpAccountName

Nome da tradurre.

[in] AccountNameFormat

Formato del nome da tradurre. Questo parametro è un valore del tipo di enumerazione EXTENDED_NAME_FORMAT .

[in] DesiredNameFormat

Formato del nome convertito. Questo parametro è un valore del tipo di enumerazione EXTENDED_NAME_FORMAT . Non può essere NameUnknown.

[out] lpTranslatedName

Puntatore a un buffer che riceve il nome convertito.

[in, out] nSize

In input, la variabile indica le dimensioni del buffer lpTranslatedName , in TCHAR. Nell'output, la variabile restituisce le dimensioni della stringa restituita, in TCHAR, incluso il carattere null di terminazione.

Se lpTranslated è NULL e nSize è 0, la funzione ha esito positivo e nSize riceve le dimensioni del buffer necessarie.

Se il buffer lpTranslatedName è troppo piccolo per contenere il nome convertito, la funzione ha esito negativo e nSize riceve le dimensioni del buffer necessarie.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

TranslateName ha esito negativo se non è in grado di eseguire l'associazione ad Active Directory in un controller di dominio.

Nota

L'intestazione secext.h definisce TranslateName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione secext.h (include Security.h)
Libreria Secur32.lib
DLL Secur32.dll
Set di API ext-ms-win-secur32-translatename-l1-1-0 (introdotto in Windows 8)

Vedi anche

Nomi computer

DsCrackNames

EXTENDED_NAME_FORMAT

Funzioni di informazioni di sistema