ldap_explode_dnW-Funktion (winldap.h)

Die ldap_explode_dn-Funktion unterteilt einen Eintragsnamen in seine Komponententeile.

Syntax

WINLDAPAPI PWCHAR *LDAPAPI ldap_explode_dnW(
  [in] const PWSTR dn,
  [in] ULONG       notypes
);

Parameter

[in] dn

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den zu explodierenden Distinguished Name enthält. Die Zeichenfolge, auf die dieser Zeiger verweist, darf keine konstante Zeichenfolge sein.

[in] notypes

Gibt an, ob die Typinformationskomponenten entfernt werden sollen.

Rückgabewert

Wenn die Funktion erfolgreich verläuft, wird ein array mit Null-Gekündigter Zeichen zurückgegeben, das die relativen Namenkomponenten des angegebenen Distinguished Name enthält.

Bemerkungen

Rufen Sie ldap_explode_dn auf, um einen unterschiedenen Namen in seine Komponententeile zu trennen. Legen Sie die notypes Parameter auf einen Wert ungleich Null fest, um Typinformationen zu entfernen, z. B. "cn=" aus den Komponenten. Die Komponenten des relativen Distinguished Name werden in einem Zeichenarray zurückgegeben. Geben Sie dieses Array frei, wenn es nicht mehr benötigt wird, indem Sie ldap_value_freeaufrufen.

Wenn Sie ldap_explode_dn mit einem Zeiger auf eine konstante Zeichenfolge aufrufen, schlägt die Funktion fehl.

Anmerkung

Der winldap.h-Header definiert ldap_explode_dn 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 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

Siehe auch

Funktionen

ldap_value_free