Partager via

SaslSetContextOption, fonction (sspi.h)

  • Article

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