TranslateNameA-Funktion (secext.h)

  • Artikel

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)

Weitere Informationen

Computernamen

DsCrackNames

EXTENDED_NAME_FORMAT

Systeminformationsfunktionen