ADS_OPTION_ENUM-Enumeration (iads.h)

Artikel
08/24/2023

Der ADS_OPTION_ENUM-Enumerationstyps enthält Werte, die die Optionen angeben, die mit den Methoden IADsObjectOptions.GetOption und IADsObjectOptions.SetOption abgerufen oder festgelegt werden können.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0001_0077_0001 {
  ADS_OPTION_SERVERNAME = 0,
  ADS_OPTION_REFERRALS,
  ADS_OPTION_PAGE_SIZE,
  ADS_OPTION_SECURITY_MASK,
  ADS_OPTION_MUTUAL_AUTH_STATUS,
  ADS_OPTION_QUOTA,
  ADS_OPTION_PASSWORD_PORTNUMBER,
  ADS_OPTION_PASSWORD_METHOD,
  ADS_OPTION_ACCUMULATIVE_MODIFICATION,
  ADS_OPTION_SKIP_SID_LOOKUP
} ADS_OPTION_ENUM;

Konstanten


`ADS_OPTION_SERVERNAME` Wert: 0 Ruft einen VT_BSTR ab, der den Hostnamen des Servers für die aktuelle Bindung enthält. an dieses Objekt. Diese Option wird vom IADsObjectOptions.SetOption-Methode .
`ADS_OPTION_REFERRALS` Ruft einen VT_I4 Wert ab, der angibt, wie die Verweisverfolge in einem zu erstellen. Diese Option kann eine der Folgenden enthalten: Vom ADS_CHASE_REFERRALS_ENUM definierte Werte Enumeration.
`ADS_OPTION_PAGE_SIZE` Ruft einen VT_I4 Wert ab, der die Seitengröße in einer Seitensuche angibt, oder legt diesen fest.
`ADS_OPTION_SECURITY_MASK` Ruft einen VT_I4-Wert ab, der die Sicherheitsdeskriptordaten steuert, die sein können, oder legt diesen fest. lesen Sie das -Objekt. Diese Option kann eine beliebige Kombination der werte enthalten, die im ADS_SECURITY_INFO_ENUM-Enumeration .
`ADS_OPTION_MUTUAL_AUTH_STATUS` Ruft einen VT_I4-Wert ab, der bestimmt, ob die gegenseitige Authentifizierung durch die SSPI-Ebene. Wenn der zurückgegebene Optionswert das flag ISC_RET_MUTUAL_AUTH enthält, in Sspi.h definiert, wurde dann eine gegenseitige Authentifizierung durchgeführt. Wenn der zurückgegebene Optionswert nicht enthält das flag ISC_RET_MUTUAL_AUTH , dann wurde keine gegenseitige Authentifizierung durchgeführt. Für Weitere Informationen zur gegenseitigen Authentifizierung finden Sie unter SSPI. Diese -Option wird von der IADsObjectOptions.SetOption-Methode .
`ADS_OPTION_QUOTA` Ermöglicht das Lesen des effektiven Kontingents und des verwendeten Kontingents eines Sicherheitsprinzipals. Diese Option verwendet VT_BSTR Wert, der den Sicherheitsprinzipal enthält, für den die Kontingente gelesen werden können. Wenn die Sicherheitsprinzipalzeichenfolge die Länge null hat oder der Wert ein VT_EMPTY Wert ist, Der Sicherheitsprinzipal ist der derzeit angemeldete Benutzer. Diese Option wird nur von unterstützt. IADsObjectOptions.SetOption-Methode .
`ADS_OPTION_PASSWORD_PORTNUMBER` Ruft einen VT_I4 Wert ab, der die Portnummer enthält, die ADSI verwendet, oder legt diesen fest. Stellen Sie eine Verbindung her, wenn das Kennwort festgelegt oder geändert wird. Standardmäßig verwendet ADSI Port 636, um eine Verbindung herstellen, um das Kennwort festzulegen oder zu ändern.
`ADS_OPTION_PASSWORD_METHOD` Ruft einen VT_I4 Wert ab, der die Kennwortcodierungsmethode angibt, oder legt diesen fest. Diese Option kann einen der in der ADS_PASSWORD_ENCODING_ENUM Enumeration.
`ADS_OPTION_ACCUMULATIVE_MODIFICATION` Enthält einen VT_BOOL-Wert , der angibt, ob Attributwert-Vorgänge geändert werden. sollte akkumuliert werden. Wenn ein Attributwert mehr als einmal geändert wird, wird standardmäßig der vorherige Wert geändert. der Änderungsvorgang wird durch den neueren Vorgang überschrieben. Wenn diese Option auf festgelegt ist VARIANT_TRUE wird jeder Attributwertänderungsvorgang im Cache akkumuliert. Wenn der Attributwert aktualisiert wird, wird ein Commit an den Server mit dem IADs.SetInfo-Methode , jede Einzelne akkumuliert wird an den Server gesendet. Wenn diese Option auf VARIANT_TRUE festgelegt wurde, kann sie nicht auf zurückgesetzt werden. VARIANT_FALSE für die Lebensdauer des ADSI-Objekts. Um diese Option zurückzusetzen, alle Verweise auf das ADSI-Objekt müssen freigegeben werden, und das Objekt muss erneut an gebunden werden. Wenn das Objekt gebunden ist für wird diese Option standardmäßig auf VARIANT_FALSE festgelegt. Diese Option wirkt sich nur auf Attributwerte aus, die mit der IADs.PutEx und IADsPropertyList.PutPropertyItem Methoden. Diese Option wird von der IADs.Put-Methode ignoriert.
`ADS_OPTION_SKIP_SID_LOOKUP` Wenn diese Option für das Objekt festgelegt ist, werden keine Nachschlagevorgänge ausgeführt (entweder während des Abrufs oder während Änderung). Diese Option wirkt sich auf die IADs und IADsPropertyList-Schnittstellen . Es ist auch anwendbar. beim Abrufen der effektiven Kontingentnutzung eines bestimmten Benutzers.