Partager via

Structure SecBuffer (sspi.h)

  • Article

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