Partager via

Fonction SaslGetContextOption (sspi.h)

  • Article

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