Fonction SaslGetContextOption (sspi.h)

Article
08/26/2023

La fonction SaslGetContextOption récupère la propriété spécifiée du contexte SASL spécifié.

Syntaxe

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

Paramètres

[in] ContextHandle

Gérer le contexte SASL.

[in] Option

Propriété à retourner à partir du contexte SASL. Le tableau suivant répertorie les valeurs possibles.

Valeur	Signification
SASL_OPTION_AUTHZ_PROCESSING	Type de données de 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.
SASL_OPTION_AUTHZ_STRING	Type de données de mémoire tampon : tableau de caractères binaires Chaîne de caractères transmis 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 mémoire tampon : ULONG Taille maximale de la mémoire tampon de réception sur l’ordinateur local.
SASL_OPTION_SEND_SIZE	Type de données de mémoire tampon : ULONG Taille maximale des données de message pouvant être transmises. Cette valeur est la taille maximale de la mémoire tampon 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.

[out] Value

Pointeur vers une mémoire tampon qui reçoit la propriété demandée. Pour connaître le type de données de la mémoire tampon pour chaque valeur du paramètre Option , consultez le paramètre Option .

[out] Size

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

[out, optional] Needed

Pointeur vers une valeur LONG non signée qui retourne la valeur si 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 .

Valeur retournée

Si l’appel est terminé avec succès, cette fonction retourne SEC_E_OK. Le tableau suivant montre 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


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