LDAPControlA-Struktur (winldap.h)
Die LDAPControl-Struktur stellt sowohl clientseitige als auch Serversteuerelemente dar.
Syntax
typedef struct ldapcontrolA {
PCHAR ldctl_oid;
struct berval ldctl_value;
BOOLEAN ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;
Member
ldctl_oid
Zeiger auf eine breite, NULL-endende Zeichenfolge, die den Steuerelementtyp angibt, z. B. "1.2.840.113556.1.4.805".
ldctl_value
Die dem Steuerelement zugeordneten Daten, falls vorhanden. Wenn dem Steuerelement keine Daten zugeordnet sind, legen Sie dieses Element auf NULL fest.
ldctl_iscritical
Gibt an, ob das Steuerelement kritisch ist, das als Feld "Kritischität" bezeichnet wird.
Hinweise
Ab LDAP 3 können Sie LDAP-Vorgänge mithilfe von Steuerelementen erweitern. Serversteuerelemente können an den Server gesendet oder mit einer beliebigen LDAP-Nachricht an den Client zurückgegeben werden. Clientsteuerelemente erweitern das Verhalten der LDAP-API nur clientseitig und werden nie an den Server gesendet. Ein unterstütztes Steuerelement wird als Objektbezeichner (Object Identifier, OID) im Verzeichnisdienststamm gespeichert.
Der ldctl_iscritical-Member ermöglicht einen erfolgreichen erweiterten Vorgang, wenn der Server oder Client das Steuerelement nicht unterstützt. Wenn der Wert dieses Felds null ist, ignoriert der Server und/oder Client das Steuerelement, wenn es nicht unterstützt wird, und führt den Vorgang aus. Wenn der Wert ungleich null ist, wird der Vorgang nur ausgeführt, wenn das Steuerelement vom Server und/oder Client erkannt wird.
Weitere Informationen sowie eine Liste der unterstützten erweiterten LDAP-Steuerelemente und deren Beschreibungen finden Sie unter Erweiterte Steuerelemente.
Hinweis
Der winldap.h-Header definiert LDAPControl 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Kopfzeile | winldap.h |