Funzione TranslateNameA (secext.h)
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) |