Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die funktion ldap_ufn2dn konvertiert einen benutzerfreundlichen Namen in einen distinguished name.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_ufn2dnW(
[in] const PWSTR ufn,
[out] PWSTR *pDn
);
Parameter
[in] ufn
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den zu konvertierenden benutzerfreundlichen Namen enthält.
[out] pDn
Zeiger auf eine Variable, die einen Zeiger auf eine mit Null beendete Zeichenfolge empfängt, die den resultierenden Distinguished-Namen enthält.
Wenn der pDn Parameter nicht-NULL-zurückgibt, geben Sie ihn mit einem Aufruf von ldap_memfreefrei.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.
Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte.
Bemerkungen
Die ldap_ufn2dn-Funktion versucht, einen vom Benutzer angegebenen Namen auf einen distinguishierten Namen zu normalisieren. Ziehen Sie z. B. ein LDAP-Verzeichnisformat für einen allgemeinen Namen von Nachname, FirstName-in Betracht. Angesichts eines Verzeichnisnamens von "Jeff Smith" wird ldap_ufn2dn versuchen, dies auf "Smith, Jeff" zu normalisieren. Die Funktion folgt RFC 1781; Add CN= if not present, add OU= if none present, and so on. Wenn beim Normalisieren Fehler auftreten, gibt die Funktion eine Kopie des übergebenen Werts zurück. Anschließend wird die Ausgabezeichenfolge aus dem LDAP-Speicherpool zugewiesen.
Anmerkung
Der winldap.h-Header definiert ldap_ufn2dn als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | winldap.h |
| Library | Wldap32.lib |
| DLL- | Wldap32.dll |