ldap_parse_vlv_controlW-Funktion (winldap.h)

2024-11-20

Die funktion ldap_parse_vlv_control wird verwendet, um VLV-Suchergebnisse zu finden und zu analysieren.

Syntax

WINLDAPAPI INT LDAPAPI ldap_parse_vlv_controlW(
  [in]  PLDAP         ExternalHandle,
  [in]  PLDAPControlW *Control,
  [out] PULONG        TargetPos,
  [out] PULONG        ListCount,
  [out] PBERVAL       *Context,
  [out] PINT          ErrCode
);

Parameter

[in] ExternalHandle

Das LDAP-Sitzungshandle.

[in] Control

Die Adresse eines NULL-beendeten Arrays von LDAPControl- Strukturen, die normalerweise durch einen Aufruf von ldap_parse_resultabgerufen werden.

[out] TargetPos

Die numerische Position des Zieleintrags in der Resultsetliste, wie vom targetPosition-Element des BER-codierten Antwortsteuerelements angegeben (LDAP_CONTROL_VLVRESPONSE). Wenn dieser Parameter NULL-ist, wird die Zielposition nicht zurückgegeben.

[out] ListCount

Die Serverschätzung der Anzahl der Einträge in der Liste gemäß dem contentCount-Element des BER-codierten Antwortsteuerelements (LDAP_CONTROL_VLVRESPONSE). Wenn dieser Parameter NULL-ist, wird die Größe nicht zurückgegeben.

[out] Context

Der vom Server generierte Kontextbezeichner. Wenn der Server keinen Kontextbezeichner zurückgibt, wird dieser Parameter auf NULL-festgelegt. Wenn NULL- für Contextp übergeben wird, wird der Kontextbezeichner nicht zurückgegeben.

[out] ErrCode

Der VLV-Ergebniscode, wie vom virtualListViewResult-Element des BER-codierten Antwortsteuerelements (LDAP_CONTROL_VLVRESPONSE). Wenn dieser Parameter NULL-ist, wird der Ergebniscode nicht zurückgegeben.

Rückgabewert

Diese Funktion gibt einen LDAP-Fehlercode zurück, der angibt, ob ein VLV-Ergebnissteuerelement gefunden und erfolgreich analysiert wurde. LDAP_SUCCESS wird zurückgegeben, wenn alles gut verläuft, LDAP_CONTROL_MISSING zurückgegeben wird, wenn das Strg- Array kein Antwortsteuerelement (LDAP_CONTROL_VLVRESPONSE) enthält und ein anderer LDAP-Fehlercode zurückgegeben wird, wenn ein Analysefehler oder ein anderes Problem auftritt.

VLV verwendet die folgenden LDAP-Rückgabewertcodes:

LDAP_OPERATIONS_ERROR

LDAP_UNWILLING_TO_PERFORM

LDAP_INSUFFICIENT_ACCESS

LDAP_BUSY

LDAP_TIMELIMIT_EXCEEDED

LDAP_ADMINLIMIT_EXCEEDED

LDAP_OTHER

Darüber hinaus wurden die folgenden beiden Codes zur Unterstützung von VLV hinzugefügt:

Bemerkungen

Dieses Steuerelement analysiert die vom Server zurückgegebenen Suchergebnisse im Antwortsteuerelement (LDAP_CONTROL_VLVRESPONSE). Ein Kontextbezeichner wird vom Server an den Client übergeben, um das Steuerelement zu identifizieren, das am Ende der Sitzung durch Aufrufen von ber_bvfreefreigegeben werden muss.

Weitere Informationen und ein Codebeispiel finden Sie unter Example Code for Using LDAP VLV.

Anmerkung

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