SaslSetContextOption-Funktion (sspi.h)

Artikel
03/02/2024

Die SaslSetContextOption-Funktion legt den Wert der angegebenen Eigenschaft für den angegebenen SASL-Kontext fest.

Syntax

SECURITY_STATUS SEC_ENTRY SaslSetContextOption(
  [in] PCtxtHandle ContextHandle,
  [in] ULONG       Option,
  [in] PVOID       Value,
  [in] ULONG       Size
);

Parameter

[in] ContextHandle

Handle des SASL-Kontexts.

[in] Option

Eigenschaft, die für den SASL-Kontext festgelegt werden soll. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
SASL_OPTION_AUTHZ_PROCESSING	Datentyp des Puffers: ULONG Status der SASL-Verarbeitung des von der SASL-Anwendung bereitgestellten Authz-Werts. Die gültigen Zustände für die Verarbeitung sind Sasl_AuthZIDForbidden und Sasl_AuthZIDProcessed. Der Standardwert ist Sasl_AuthZIDProcessed.
SASL_OPTION_AUTHZ_STRING	Datentyp des Puffers: Array von Binärzeichen Zeichenfolge, die vom SASL-Client an den Server übergeben wird. Wenn der AuthZ_Processing Zustand Sasl_AuthZIDForbidden ist, wird der Rückgabewert SEC_E_UNSUPPORTED_FUNCTION zurückgegeben.
SASL_OPTION_RECV_SIZE	Datentyp des Puffers: ULONG Maximale Größe des Empfangspuffers auf dem lokalen Computer. Der Standardwert ist 0x0FFFF Bytes.
SASL_OPTION_SEND_SIZE	Datentyp des Puffers: ULONG Maximale Nachrichtendatengröße, die übertragen werden kann. Dieser Wert ist die maximale Puffergröße, die an den SASL-Remoteprozess übertragen werden kann, abzüglich der Blockgröße, der Anhängergröße und der maximalen Signaturgröße. Der Standardwert ist 0x0FFFF Bytes.

[in] Value

Ein Zeiger auf einen Puffer, der den Wert enthält, der auf die angeforderte Eigenschaft festgelegt werden soll. Den Datentyp des Puffers für jeden Wert des Option-Parameters finden Sie im Parameter Option .

[in] Size

Die Größe des Puffers, der durch den Value-Parameter angegeben wird, in Byte.

Rückgabewert

Wenn der Aufruf erfolgreich abgeschlossen wurde, gibt diese Funktion SEC_E_OK zurück. In der folgenden Tabelle sind einige mögliche Fehlerrückgabewerte aufgeführt.

Rückgabecode	Beschreibung
SEC_E_BUFFER_TOO_SMALL	Der durch den Value-Parameter angegebene Puffer ist nicht groß genug, um den Datenwert der durch den Parameter Option angegebenen Eigenschaft zu enthalten.
SEC_E_INVALID_HANDLE	Das vom ContextHandle-Parameter angegebene SASL-Kontexthandle wurde in der SASL-Liste nicht gefunden.
SEC_E_UNSUPPORTED_FUNCTION	Die im Parameter Option angegebene Option ist ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sspi.h (einschließlich Security.h)
Bibliothek	Secur32.lib
DLL	Secur32.dll

Freigeben über