LDAPModW-Struktur (winldap.h)

2024-11-20

Die LDAPMod--Struktur enthält Daten, die zum Ausführen eines Änderungsvorgangs erforderlich sind.

Syntax

typedef struct ldapmodW {
  ULONG  mod_op;
  PWCHAR mod_type;
  union {
    PWCHAR *modv_strvals;
    berval **modv_bvals;
  } mod_vals;
} LDAPModW, *PLDAPModW;

Angehörige

mod_op

Gibt einen der folgenden Werte an, um den auszuführenden Änderungsvorgang anzugeben.

Sie können den bitweisen ODER--Operator verwenden, um den Vorgangswert mit LDAP_MOD_BVALUES zu kombinieren, um anzugeben, dass die mod_vals Union das modv_bvals Mitglied verwendet. Wenn LDAP_MOD_BVALUES nicht festgelegt ist, verwendet die Union das modv_strvals Mitglied.

LDAP_MOD_ADD (0x00)

Fügt dem Eintrag einen Wert hinzu. Die angegebenen Werte werden an die vorhandenen Werte im Attribut angefügt.

LDAP_MOD_DELETE (0x01)

Löscht einen Wert im Eintrag. Die angegebenen Werte werden aus den aktuellen Attributwerten gelöscht.

LDAP_MOD_REPLACE (0x02)

Ersetzt einen Wert im Eintrag. Die angegebenen Werte ersetzen die vorhandenen Attributwerte.

mod_type

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des zu ändernden Attributs angibt.

mod_vals

Zeigen Sie auf ein Array von Werten( falls vorhanden), um sie hinzuzufügen, zu löschen oder zu ersetzen. Wenn mop_op das LDAP_MOD_BVALUES-Flag nicht enthält, ist der modv_strvals Member ein Zeiger auf ein Array mit null-beendeten Zeichenfolgen. Wenn mop_op LDAP_MOD_BVALUES enthält, ist das modv_bvals-Element ein Zeiger auf ein Array von berval Zeigern, die für die Angabe von Binärwerten nützlich sind.

mod_vals.modv_strvals

Zeiger auf ein null-beendetes Array mit null-beendeten Zeichenfolgen. Das letzte Element des Arrays muss ein NULL- Zeiger sein.

mod_vals.modv_bvals

Zeiger auf ein NULL--terminated-Array von berval Zeigern. Das letzte Element des Arrays muss ein NULL- Zeiger sein.

Bemerkungen

Weisen Sie den Feldern der LDAPMod- Struktur Werte zu, bevor Sie eine Änderungsfunktion aufrufen ( ldap_add*oder ldap_modify*).

ldap_modify* mit dem LDAP_MOD_REPLACE-Vorgang löscht kein Attribut, wenn ein NULL-Zeiger übergeben wird. LDAP_MOD_DELETE löscht jedoch das gesamte Attribut, wenn mod_vals auf NULL-festgelegt ist.

Beim Übergeben einer LDAPMod- Struktur in die ldap_add*--Funktionen ist nur das LDAP_MOD_BVALUES Flag von Bedeutung. Das Erstellen eines neuen Objekts impliziert das Hinzufügen von Werten.

Anmerkung

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