Funzione SaslSetContextOption (sspi.h)

  • Articolo

La funzione SaslSetContextOption imposta il valore della proprietà specificata per il contesto SASL specificato.

Sintassi

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

Parametri

[in] ContextHandle

Handle del contesto SASL.

[in] Option

Proprietà da impostare per il contesto SASL. Nella tabella seguente sono elencati i valori possibili.

Valore Significato
SASL_OPTION_AUTHZ_PROCESSING
 Tipo di dati del buffer: ULONG

Stato dell'elaborazione SASL del valore Authz fornito dall'applicazione SASL. Gli stati validi per l'elaborazione sono Sasl_AuthZIDForbidden e Sasl_AuthZIDProcessed. Il valore predefinito è Sasl_AuthZIDProcessed.
SASL_OPTION_AUTHZ_STRING
 Tipo di dati del buffer: matrice di caratteri binari

Stringa di caratteri passati dal client SASL al server. Se lo stato AuthZ_Processing è Sasl_AuthZIDForbidden, viene restituito il valore restituito SEC_E_UNSUPPORTED_FUNCTION.
SASL_OPTION_RECV_SIZE
 Tipo di dati del buffer: ULONG

Dimensioni massime del buffer ricevente nel computer locale. Il valore predefinito è 0x0FFFF byte.
SASL_OPTION_SEND_SIZE
 Tipo di dati del buffer: ULONG

Dimensione massima dei dati dei messaggi che è possibile trasmettere. Questo valore è la dimensione massima del buffer che può essere trasmessa al processo SASL remoto meno le dimensioni del blocco, le dimensioni del trailer e le dimensioni massime della firma. Il valore predefinito è 0x0FFFF byte.

[in] Value

Puntatore a un buffer contenente il valore da impostare sulla proprietà richiesta. Per il tipo di dati del buffer per ogni valore del parametro Option , vedere il parametro Option .

[in] Size

Dimensione, in byte, del buffer specificato dal parametro Value .

Valore restituito

Se la chiamata viene completata correttamente, questa funzione restituisce SEC_E_OK. La tabella seguente illustra alcuni possibili valori restituiti dall'errore.

Codice restituito Descrizione
SEC_E_BUFFER_TOO_SMALL
 Il buffer specificato dal parametro Value non è sufficientemente grande da contenere il valore di dati della proprietà specificata dal parametro Option .
SEC_E_INVALID_HANDLE
 L'handle di contesto SASL specificato dal parametro ContextHandle non è stato trovato nell'elenco SASL.
SEC_E_UNSUPPORTED_FUNCTION
 L'opzione specificata nel parametro Option non è valida.

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione sspi.h (include Security.h)
Libreria Secur32.lib
DLL Secur32.dll