TranslateNameA-Funktion (secext.h)
Konvertiert den Namen eines Verzeichnisdienstobjekts aus einem Format in ein anderes.
Syntax
BOOLEAN SEC_ENTRY TranslateNameA(
[in] LPCSTR lpAccountName,
[in] EXTENDED_NAME_FORMAT AccountNameFormat,
[in] EXTENDED_NAME_FORMAT DesiredNameFormat,
[out] LPSTR lpTranslatedName,
[in, out] PULONG nSize
);
Parameter
[in] lpAccountName
Der zu übersetzende Name.
[in] AccountNameFormat
Das Format des zu übersetzenden Namens. Dieser Parameter ist ein Wert aus dem EXTENDED_NAME_FORMAT Enumerationstyp.
[in] DesiredNameFormat
Das Format des konvertierten Namens. Dieser Parameter ist ein Wert aus dem EXTENDED_NAME_FORMAT Enumerationstyp. Es kann nicht NameUnknown sein.
[out] lpTranslatedName
Ein Zeiger auf einen Puffer, der den konvertierten Namen empfängt.
[in, out] nSize
Bei der Eingabe gibt die Variable die Größe des Puffers lpTranslatedName in TCHARs an. Bei der Ausgabe gibt die Variable die Größe der zurückgegebenen Zeichenfolge in TCHARs zurück, einschließlich des beendenden NULL-Zeichens .
Wenn lpTranslatedNULL und nSize 0 ist, wird die Funktion erfolgreich ausgeführt, und nSize empfängt die erforderliche Puffergröße.
Wenn der Puffer lpTranslatedName zu klein ist, um den konvertierten Namen zu speichern, schlägt die Funktion fehl, und nSize empfängt die erforderliche Puffergröße.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
TranslateName schlägt fehl, wenn keine Bindung an Active Directory auf einem Domänencontroller möglich ist.
Hinweis
Der secext.h-Header definiert TranslateName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | secext.h (einschließlich Security.h) |
Bibliothek | Secur32.lib |
DLL | Secur32.dll |
APIs | ext-ms-win-secur32-translatename-l1-1-0 (eingeführt in Windows 8) |