Structure SecBuffer (sspi.h)

Article
03/08/2023

La structure SecBuffer décrit une mémoire tampon allouée par une application de transport à passer à un package de sécurité.

Syntaxe

typedef struct _SecBuffer {
  unsigned long cbBuffer;
  unsigned long BufferType;
#if ...
  char          *pvBuffer;
#else
  void SEC_FAR  *pvBuffer;
#endif
} SecBuffer, *PSecBuffer;

Membres

cbBuffer

Spécifie la taille, en octets, de la mémoire tampon pointée vers le membre pvBuffer .

BufferType

Indicateurs de bits qui indiquent le type de mémoire tampon. BufferType doit être l’un des indicateurs suivants.

Valeur	Signification
SECBUFFER_ALERT 17 (0x11)	La mémoire tampon contient un message d’alerte.
SECBUFFER_ATTRMASK 4026531840 (0xF0000000)	La mémoire tampon contient un masque de bits pour une mémoire tampon SECBUFFER_READONLY_WITH_CHECKSUM.
SECBUFFER_CHANNEL_BINDINGS 14 (0xE)	La mémoire tampon contient des informations de liaison de canal.
SECBUFFER_CHANGE_PASS_RESPONSE 15 (0xF)	La mémoire tampon contient une structure DOMAIN_PASSWORD_INFORMATION .
SECBUFFER_DATA 1 (0x1)	La mémoire tampon contient des données courantes. Le package de sécurité peut lire et écrire ces données, par exemple, pour chiffrer tout ou partie de celles-ci.
SECBUFFER_DTLS_MTU 24 (0x18)	La mémoire tampon contient le paramètre de la taille de l’unité de transmission maximale (MTU) pour DTLS uniquement. La valeur par défaut est 1096 et la plage configurable valide est comprise entre 200 et 64*1024.
SECBUFFER_EMPTY 0 (0x0)	Il s’agit d’un espace réservé dans le tableau de mémoires tampons. L’appelant peut fournir plusieurs entrées de ce type dans le tableau, et le package de sécurité peut y retourner des informations. Pour plus d’informations, consultez Sémantique du contexte SSPI.
SECBUFFER_EXTRA 5 (0x5)	Le package de sécurité utilise cette valeur pour indiquer le nombre d’octets supplémentaires ou non traités dans un message.
SECBUFFER_MECHLIST 11 (0xB)	La mémoire tampon contient une liste spécifique au protocole d’identificateurs d’objets (OID). Il n’est généralement pas intéressant pour les appelants.
SECBUFFER_MECHLIST_SIGNATURE 12 (0xC)	La mémoire tampon contient une signature d’une mémoire tampon SECBUFFER_MECHLIST . Il n’est généralement pas intéressant pour les appelants.
SECBUFFER_MISSING 4 (0x4)	Le package de sécurité utilise cette valeur pour indiquer le nombre d’octets manquants dans un message particulier. Le membre pvBuffer est ignoré dans ce type.
SECBUFFER_PKG_PARAMS 3 (0x3)	Il s’agit de paramètres spécifiques du transport vers le package. Par exemple, le redirecteur NetWare peut fournir l’identificateur d’objet serveur, tandis que DCE RPC peut fournir un UUID d’association, etc.
SECBUFFER_PRESHARED_KEY 22 (0x16)	La mémoire tampon contient la clé prépartagée. La taille maximale autorisée de la mémoire tampon PSK est de 256 octets.
SECBUFFER_PRESHARED_KEY_IDENTITY 23 (0x17)	La mémoire tampon contient l’identité de clé prépartagée.
SECBUFFER_SRTP_MASTER_KEY_IDENTIFIER 20 (0x14)	La mémoire tampon contient l’identificateur de clé SRTP master.
SECBUFFER_SRTP_PROTECTION_PROFILES 19 (0x13)	La mémoire tampon contient la liste des profils de protection SRTP, dans l’ordre décroissant de préférence.
SECBUFFER_STREAM_HEADER 7 (0x7)	La mémoire tampon contient un en-tête spécifique au protocole pour un enregistrement particulier. Il n’est généralement pas intéressant pour les appelants.
SECBUFFER_STREAM_TRAILER 6 (0x6)	La mémoire tampon contient une bande-annonce spécifique au protocole pour un enregistrement particulier. Il n’est généralement pas intéressant pour les appelants.
SECBUFFER_TARGET 13 (0xD)	Cet indicateur est réservé. Ne pas l'utiliser.
SECBUFFER_TARGET_HOST 16 (0x10)	La mémoire tampon spécifie le nom du principal de service (SPN) de la cible. Cette valeur est prise en charge par le package de sécurité Digest lorsqu’elle est utilisée avec des liaisons de canal. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge.
SECBUFFER_TOKEN 2 (0x2)	La mémoire tampon contient la partie du jeton de sécurité du message. Il s’agit de la lecture seule pour les paramètres d’entrée ou de la lecture/écriture pour les paramètres de sortie.
SECBUFFER_TOKEN_BINDING 21 (0x15)	La mémoire tampon contient la version du protocole de liaison de jeton prise en charge et les paramètres de clé, dans l’ordre décroissant de préférence.
SECBUFFER_APPLICATION_PROTOCOLS 18	La mémoire tampon contient une liste d’ID de protocole d’application, une liste par type d’extension de négociation de protocole d’application à activer.

En outre, BufferType peut combiner les indicateurs suivants avec l’un des indicateurs du tableau précédent à l’aide d’une opération OR au niveau du bit.

Valeur	Signification
SECBUFFER_READONLY 2147483648 (0x80000000)	La mémoire tampon est en lecture seule sans somme de contrôle. Cet indicateur est destiné à envoyer des informations d’en-tête au package de sécurité pour le calcul de la somme de contrôle. Le package peut lire cette mémoire tampon, mais ne peut pas la modifier.
SECBUFFER_READONLY_WITH_CHECKSUM 268435456 (0x10000000)	La mémoire tampon est en lecture seule avec une somme de contrôle.

pvBuffer

Pointeur vers une mémoire tampon.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
En-tête	sspi.h (include Security.h)

Voir aussi

SecBufferDesc

Share via