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 ldap_parse_extended_result analysiert die Ergebnisse eines erweiterten LDAP-Vorgangs.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_parse_extended_resultA(
[in] LDAP *Connection,
[in] LDAPMessage *ResultMessage,
[out] PSTR *ResultOID,
[out] berval **ResultData,
[in] BOOLEAN Freeit
);
Parameter
[in] Connection
Das Sitzungshandle.
[in] ResultMessage
Ein Zeiger auf eine LDAPMessage- Struktur, die von ldap_result als Reaktion auf eine erweiterte Vorgangsanforderung zurückgegeben wird.
[out] ResultOID
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die die OID-Textzeichenfolge (Dotted Object Identifier) der Antwortnachricht des Servers enthält. Dies ist normalerweise dieselbe OID wie die, die die Anforderung benennt, die ursprünglich von ldap_extended_operationan den Server übergeben wurde.
[out] ResultData
Die vom erweiterten Vorgang zurückgegebenen beliebigen Daten (wenn NULL-, werden keine Daten vom Server zurückgegeben).
[in] Freeit
Bestimmt, ob der parameter ResultMessage freigegeben ist. Sie können einen beliebigen Nonzero-Wert an den Freeit Parameter übergeben, um den ResultMessage Zeiger freizulassen, wenn er nicht mehr benötigt wird, oder Sie können ldap_msgfree aufrufen, um das Ergebnis später freizulassen.
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
Wenn ein Server eine von ldap_extended_operationgenerierte erweiterte Vorgangsanforderung verarbeitet, wird eine LDAP-Nachricht zusammen mit einem LDAP_RES_EXTENDED Rückgabecode zurückgegeben. Verwenden Sie ldap_parse_extended_result, um diese Ergebnismeldung zu analysieren, die sowohl den Text OID der ursprünglichen Nachricht in ResultOID- als auch beliebige Daten zurückgibt, die vom erweiterten Vorgang in ResultDatageneriert werden.
Wenn sie nicht mehr benötigt werden, geben Sie die ResultOID- Zeichenfolge und den ResultData Puffer durch Aufrufen von ldap_memfreefrei.
Anmerkung
Der winldap.h-Header definiert ldap_parse_extended_result 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 |