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_create_vlv_control-Funktion wird verwendet, um das Anforderungssteuerelement (LDAP_CONTROL_VLVREQUEST) auf dem Server zu erstellen.
Syntax
WINLDAPAPI INT LDAPAPI ldap_create_vlv_controlW(
[in] PLDAP ExternalHandle,
[in] PLDAPVLVInfo VlvInfo,
[in] UCHAR IsCritical,
[out] PLDAPControlW *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 |