ldap_create_vlv_controlA-Funktion (winldap.h)
Die ldap_create_vlv_control-Funktion wird verwendet, um das Anforderungssteuerelement (LDAP_CONTROL_VLVREQUEST) auf dem Server zu erstellen.
Syntax
WINLDAPAPI INT LDAPAPI ldap_create_vlv_controlA(
[in] PLDAP ExternalHandle,
[in] PLDAPVLVInfo VlvInfo,
[in] UCHAR IsCritical,
[out] PLDAPControlA *Control
);
Parameter
[in] ExternalHandle
Ein LDAP-Sitzungshandle, wie aus einem Aufruf von ldap_initabgerufen.
[in] VlvInfo
Die Adresse einer LDAPVLVInfo Struktur, deren Inhalt verwendet wird, um den Wert des erstellten Steuerelements zu konstruieren.
[in] IsCritical
Wenn dieser Wert nicht 0 ist, hat das erstellte Steuerelement seine Kritischität auf TRUE-festgelegt.
[out] Control
Einem Ergebnisparameter wurde die Adresse einer LDAPControl- Struktur zugewiesen, die das anforderungssteuerelement (LDAP_CONTROL_VLVREQUEST) enthält, das von dieser Funktion erstellt wurde.
Rückgabewert
Die ldap_create_vlv_control-Funktion gibt einen LDAP-Fehlercode zurück, um fehler anzugeben, oder LDAP_SUCCESS bei erfolgreicher Ausführung.
Bemerkungen
Wenn eine VLV-Suche durchgeführt wird, muss der Client diese Funktion verwenden, um ein neues VLV-Steuerelement zu erstellen, das in die an den Server gesendete Suchanforderung aufgenommen werden kann. Der Server weist eine ContextID für diese VLV-Suche zu, die an den Client übergeben wird. Wenn die VLV-Suche abgeschlossen ist, sollten Sie ldap_control_free verwenden, um das von ldap_create_vlv_controlzurückgegebene Steuerelement freizugeben, und ldap_controls_free, um das Steuerelement zu befreien, einschließlich des VLV-Antwortsteuerelements, das von ldap_parse_resultzurückgegeben wird.
Weitere Informationen und ein Codebeispiel für diese Funktion finden Sie unter Beispielcode für die Verwendung von LDAP VLV-.
Anmerkung
Der winldap.h-Header definiert ldap_create_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 |