SaslSetContextOption function (sspi.h)

The SaslSetContextOption function sets the value of the specified property for the specified SASL context.

Syntax

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

Parameters

[in] ContextHandle

Handle of the SASL context.

[in] Option

Property to set for the SASL context. The following table lists the possible values.

Value Meaning
SASL_OPTION_AUTHZ_PROCESSING
Data type of buffer: ULONG

State of SASL processing of the Authz value provided by the SASL application. The valid states for processing are Sasl_AuthZIDForbidden and Sasl_AuthZIDProcessed. The default value is Sasl_AuthZIDProcessed.

SASL_OPTION_AUTHZ_STRING
Data type of buffer: Array of binary characters

String of characters passed from the SASL client to the server. If the AuthZ_Processing state is Sasl_AuthZIDForbidden, the return value SEC_E_UNSUPPORTED_FUNCTION is returned.

SASL_OPTION_RECV_SIZE
Data type of buffer: ULONG

Maximum size of the receiving buffer on the local computer. The default value is 0x0FFFF bytes.

SASL_OPTION_SEND_SIZE
Data type of buffer: ULONG

Maximum message data size that can be transmitted. This value is the maximum buffer size that can be transmitted to the remote SASL process minus the block size, the trailer size, and the maximum signature size. The default value is 0x0FFFF bytes.

[in] Value

A pointer to a buffer that contains the value to set to the requested property. For the data type of the buffer for each value of the Option parameter, see the Option parameter.

[in] Size

The size, in bytes, of the buffer specified by the Value parameter.

Return value

If the call is completed successfully, this function returns SEC_E_OK. The following table shows some possible error return values.

Return code Description
SEC_E_BUFFER_TOO_SMALL
The buffer specified by the Value parameter is not large enough to contain the data value of the property specified by the Option parameter.
SEC_E_INVALID_HANDLE
The SASL context handle specified by the ContextHandle parameter was not found in the SASL list.
SEC_E_UNSUPPORTED_FUNCTION
The option specified in the Option parameter is not valid.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header sspi.h (include Security.h)
Library Secur32.lib
DLL Secur32.dll