SaslSetContextOption, fonction (sspi.h)

Article
03/04/2024

La fonction SaslSetContextOption définit la valeur de la propriété spécifiée pour le contexte SASL spécifié.

Syntaxe

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

Paramètres

[in] ContextHandle

Handle du contexte SASL.

[in] Option

Propriété à définir pour le contexte SASL. Le tableau suivant répertorie les valeurs possibles.

Valeur	Signification
SASL_OPTION_AUTHZ_PROCESSING	Type de données de la mémoire tampon : ULONG État du traitement SASL de la valeur Authz fournie par l’application SASL. Les états valides pour le traitement sont Sasl_AuthZIDForbidden et Sasl_AuthZIDProcessed. La valeur par défaut est Sasl_AuthZIDProcessed.
SASL_OPTION_AUTHZ_STRING	Type de données de la mémoire tampon : tableau de caractères binaires Chaîne de caractères passée du client SASL au serveur. Si l’état AuthZ_Processing est Sasl_AuthZIDForbidden, la valeur de retour SEC_E_UNSUPPORTED_FUNCTION est retournée.
SASL_OPTION_RECV_SIZE	Type de données de la mémoire tampon : ULONG Taille maximale de la mémoire tampon de réception sur l’ordinateur local. La valeur par défaut est 0x0FFFF octets.
SASL_OPTION_SEND_SIZE	Type de données de la mémoire tampon : ULONG Taille maximale des données de message pouvant être transmises. Cette valeur est la taille de mémoire tampon maximale qui peut être transmise au processus SASL distant, moins la taille de bloc, la taille de la bande-annonce et la taille maximale de signature. La valeur par défaut est 0x0FFFF octets.

[in] Value

Pointeur vers une mémoire tampon qui contient la valeur à définir sur la propriété demandée. Pour le type de données de la mémoire tampon pour chaque valeur du paramètre Option , consultez le paramètre Option .

[in] Size

Taille, en octets, de la mémoire tampon spécifiée par le paramètre Value .

Valeur retournée

Si l’appel est terminé avec succès, cette fonction retourne SEC_E_OK. Le tableau suivant présente certaines valeurs de retour d’erreur possibles.

Code de retour	Description
SEC_E_BUFFER_TOO_SMALL	La mémoire tampon spécifiée par le paramètre Value n’est pas assez grande pour contenir la valeur de données de la propriété spécifiée par le paramètre Option .
SEC_E_INVALID_HANDLE	Le handle de contexte SASL spécifié par le paramètre ContextHandle est introuvable dans la liste SASL.
SEC_E_UNSUPPORTED_FUNCTION	L’option spécifiée dans le paramètre Option n’est pas valide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	sspi.h (include Security.h)
Bibliothèque	Secur32.lib
DLL	Secur32.dll

Share via