Condividi tramite

Funzione SaslGetContextOption (sspi.h)

  • Articolo

La funzione SaslGetContextOption recupera la proprietà specificata del contesto SASL specificato.

Sintassi

SECURITY_STATUS SEC_ENTRY SaslGetContextOption(
  [in]            PCtxtHandle ContextHandle,
  [in]            ULONG       Option,
  [out]           PVOID       Value,
  [out]           ULONG       Size,
  [out, optional] PULONG      Needed
);

Parametri

[in] ContextHandle

Handle del contesto SASL.

[in] Option

Proprietà da restituire dal 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.
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.
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.

[out] Value

Puntatore a un buffer che riceve la proprietà richiesta. Per il tipo di dati del buffer per ogni valore del parametro Option , vedere il parametro Option .

[out] Size

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

[out, optional] Needed

Puntatore a un valore LONG senza segno che restituisce il valore se il buffer specificato dal parametro Value non è sufficientemente grande da contenere il valore di dati della proprietà specificata dal parametro Option .

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

   
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