TranslateNameA-Funktion (secext.h)

Konvertiert einen Verzeichnisdienstobjektnamen 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 name, der übersetzt werden soll.

[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 lpTranslatedName- Puffers in TCHARsan. Bei der Ausgabe gibt die Variable die Größe der zurückgegebenen Zeichenfolge in TCHARs-zurück, einschließlich des endierenden NULL- Zeichens.

Wenn lpTranslated-NULL- ist und nSize 0 ist, wird die Funktion erfolgreich ausgeführt, und nSize erhält die erforderliche Puffergröße.

Wenn der lpTranslatedName Puffer zu klein ist, um den konvertierten Namen zu speichern, schlägt die Funktion fehl, und nSize die erforderliche Puffergröße erhält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

TranslateName schlägt fehl, wenn sie nicht an Active Directory auf einem Domänencontroller gebunden werden kann.

Anforderungen

Siehe auch

Computernamen

DsCrackNames-

EXTENDED_NAME_FORMAT

Systeminformationsfunktionen