ldap_parse_referenceW-Funktion (winldap.h)

2024-11-20

Die ldap_parse_reference-Funktion gibt eine Liste untergeordneter Verweise in einer Suchantwortnachricht zurück.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_parse_referenceW(
  [in]  LDAP        *Connection,
  [in]  LDAPMessage *ResultMessage,
  [out] PWCHAR      **Referrals
);

Parameter

[in] Connection

Das Sitzungshandle.

[in] ResultMessage

Ein Zeiger auf eine LDAPMessage- Struktur, die die Suchantwort enthält.

[out] Referrals

Ein Zeiger auf die Liste der untergeordneten Verweise. Kostenlos mit ldap_value_free.

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 funktion ldap_parse_reference gibt eine Liste von Verweisen in Form von URLs zurück. Rufen Sie diese Funktion auf, wenn ein Aufruf von ldap_parse_result angibt, dass Verweise vorhanden sind.

Wenn es nicht mehr benötigt wird, geben Sie den Empfehlungen Zeiger durch Aufrufen von ldap_value_freefrei.

Anmerkung

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

Freigeben über