SEC_CHANNEL_BINDINGS structure (sspi.h)

Spécifie les informations de liaison de canal pour un contexte de sécurité.

Syntaxe

typedef struct _SEC_CHANNEL_BINDINGS {
  unsigned long dwInitiatorAddrType;
  unsigned long cbInitiatorLength;
  unsigned long dwInitiatorOffset;
  unsigned long dwAcceptorAddrType;
  unsigned long cbAcceptorLength;
  unsigned long dwAcceptorOffset;
  unsigned long cbApplicationDataLength;
  unsigned long dwApplicationDataOffset;
} SEC_CHANNEL_BINDINGS, *PSEC_CHANNEL_BINDINGS;

Membres

dwInitiatorAddrType

Type d’adresse (par exemple, HTTP) spécifié pour le client.

cbInitiatorLength

Taille, en octets, des données qui spécifient l’adresse du client.

dwInitiatorOffset

Nombre d’octets entre le début de cette structure et le début des données qui spécifient l’adresse du client.

dwAcceptorAddrType

Type d’adresse (par exemple, SPN) spécifié pour le serveur.

cbAcceptorLength

Taille, en octets, des données qui spécifient l’adresse du serveur.

dwAcceptorOffset

Nombre d’octets entre le début de cette structure et le début des données qui spécifient l’adresse du serveur.

cbApplicationDataLength

Taille, en octets, des données de liaison de canal.

dwApplicationDataOffset

Taille, en octets, de cette structure. Les données de liaison de canal suivent immédiatement cette structure.

Remarques

Schannel définit sur zéro la valeur de tous les membres de cette structure autres que cbApplicationDataLength et dwApplicationDataOffset.

Les fournisseurs de support de sécurité (SSP) autres que Schannel doivent utiliser les valeurs de cette structure obtenues par un appel à la fonction QueryContextAttributes (Schannel) pour passer en tant que structure SecBuffer de type SECBUFFER_CHANNEL_BINDINGS comme l’une des mémoires tampons dans le paramètre pInput d’un appel à la fonction AcceptSecurityContext (Général).

Un fournisseur de support de sécurité (SSP) autre que Schannel doit obtenir les informations de liaison de canal spécifiées par cette structure en appelant la fonction QueryContextAttributes (Schannel) sur le contexte Schannel utilisé par le client pour l’authentification. Transmettez ces informations de liaison de canal en tant que structure SecBuffer de type SECBUFFER_CHANNEL_BINDINGS au paramètre pInput d’un appel à la fonction AcceptSecurityContext (Général).

Si la valeur du paramètre ulAttribute de la fonction QueryContextAttributes (Schannel) est SECPKG_ATTR_UNIQUE_BINDINGS, les données de liaison de canal spécifiées par cette structure commencent par « tls-unique: ».

Si la valeur du paramètre ulAttribute de la fonction QueryContextAttributes (Schannel) est SECPKG_ATTR_ENDPOINT_BINDINGS, les données de liaison de canal spécifiées par cette structure commencent par « tls-server-end-point : ».

Configuration requise

Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	sspi.h

Voir aussi

QueryContextAttributes (Schannel)

SecPkgContext_Bindings