estrutura SEC_CHANNEL_BINDINGS (sspi.h)

  • Artigo

Especifica informações de associação de canal para um contexto de segurança.

Sintaxe

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;

Membros

dwInitiatorAddrType

O tipo de endereço (por exemplo, HTTP) especificado para o cliente.

cbInitiatorLength

O tamanho, em bytes, dos dados que especificam o endereço do cliente.

dwInitiatorOffset

O número de bytes desde o início dessa estrutura até o início dos dados que especificam o endereço do cliente.

dwAcceptorAddrType

O tipo de endereço (por exemplo, SPN) especificado para o servidor.

cbAcceptorLength

O tamanho, em bytes, dos dados que especificam o endereço do servidor.

dwAcceptorOffset

O número de bytes desde o início dessa estrutura até o início dos dados que especificam o endereço do servidor.

cbApplicationDataLength

O tamanho, em bytes, dos dados de associação de canal.

dwApplicationDataOffset

O tamanho, em bytes, dessa estrutura. Os dados de associação de canal seguem imediatamente essa estrutura.

Comentários

O Schannel define como zero o valor de todos os membros dessa estrutura que não seja cbApplicationDataLength e dwApplicationDataOffset.

Os SSPs (provedores de suporte de segurança) que não sejam o Schannel devem usar os valores dessa estrutura obtidos por uma chamada para a função Schannel (QueryContextAttributes) para passar como uma estrutura SecBuffer do tipo SECBUFFER_CHANNEL_BINDINGS como um dos buffers no parâmetro pInput de uma chamada para a função AcceptSecurityContext (Geral).

Um SSP ( provedor de suporte de segurança ) diferente do Schannel deve obter as informações de associação de canal especificadas por essa estrutura chamando a função QueryContextAttributes (Schannel) no contexto Schannel que o cliente usou para autenticar. Passe essas informações de associação de canal como uma estrutura SecBuffer do tipo SECBUFFER_CHANNEL_BINDINGS para o parâmetro pInput de uma chamada para a função AcceptSecurityContext (Geral ).

Se o valor do parâmetro ulAttribute da função QueryContextAttributes (Schannel) for SECPKG_ATTR_UNIQUE_BINDINGS, os dados de associação de canal especificados por essa estrutura começarão com "tls-unique:".

Se o valor do parâmetro ulAttribute da função QueryContextAttributes (Schannel) for SECPKG_ATTR_ENDPOINT_BINDINGS, os dados de associação de canal especificados por essa estrutura começarão com "tls-server-end-point:".

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho sspi.h

Confira também

QueryContextAttributes (Schannel)

SecPkgContext_Bindings