Estrutura SecBuffer (sspi.h)

  • Artigo

A estrutura SecBuffer descreve um buffer alocado por um aplicativo de transporte para passar para um pacote de segurança.

Sintaxe

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

Membros

cbBuffer

Especifica o tamanho, em bytes, do buffer apontado pelo membro pvBuffer .

BufferType

Sinalizadores de bit que indicam o tipo de buffer. BufferType deve ser um dos sinalizadores a seguir.

Valor Significado
SECBUFFER_ALERT
17 (0x11)
 O buffer contém uma mensagem de alerta.
SECBUFFER_ATTRMASK
4026531840 (0xF0000000)
 O buffer contém uma máscara de bits para um buffer de SECBUFFER_READONLY_WITH_CHECKSUM.
SECBUFFER_CHANNEL_BINDINGS
14 (0xE)
 O buffer contém informações de associação de canal.
SECBUFFER_CHANGE_PASS_RESPONSE
15 (0xF)
 O buffer contém uma estrutura DOMAIN_PASSWORD_INFORMATION .
SECBUFFER_DATA
1 (0x1)
 O buffer contém dados comuns. O pacote de segurança pode ler e gravar esses dados, por exemplo, para criptografar alguns ou todos eles.
SECBUFFER_DTLS_MTU
24 (0x18)
 O buffer contém a configuração para o tamanho máximo da MTU (unidade de transmissão) somente para DTLS. O valor padrão é 1096 e o intervalo configurável válido está entre 200 e 64*1024.
SECBUFFER_EMPTY
0 (0x0)
 Esse é um espaço reservado na matriz de buffers. O chamador pode fornecer várias dessas entradas na matriz e o pacote de segurança pode retornar informações nelas. Para obter mais informações, consulte Semântica de Contexto de SSPI.
SECBUFFER_EXTRA
5 (0x5)
 O pacote de segurança usa esse valor para indicar o número de bytes extras ou não processados em uma mensagem.
SECBUFFER_MECHLIST
11 (0xB)
 O buffer contém uma lista específica do protocolo de identificadores de objeto (OIDs). Normalmente, não é de interesse dos chamadores.
SECBUFFER_MECHLIST_SIGNATURE
12 (0xC)
 O buffer contém uma assinatura de um buffer de SECBUFFER_MECHLIST . Normalmente, não é de interesse dos chamadores.
SECBUFFER_MISSING
4 (0x4)
 O pacote de segurança usa esse valor para indicar o número de bytes ausentes em uma mensagem específica. O membro pvBuffer é ignorado nesse tipo.
SECBUFFER_PKG_PARAMS
3 (0x3)
 São parâmetros específicos de transporte para pacote. Por exemplo, o redirecionador do NetWare pode fornecer o identificador de objeto do servidor, enquanto o DCE RPC pode fornecer uma UUID de associação e assim por diante.
SECBUFFER_PRESHARED_KEY
22 (0x16)
 O buffer contém a chave pré-compartilhada. O tamanho máximo permitido do buffer PSK é de 256 bytes.
SECBUFFER_PRESHARED_KEY_IDENTITY
23 (0x17)
 O buffer contém a identidade da chave pré-compartilhada.
SECBUFFER_SRTP_MASTER_KEY_IDENTIFIER
20 (0x14)
 O buffer contém o identificador de chave master SRTP.
SECBUFFER_SRTP_PROTECTION_PROFILES
19 (0x13)
 O buffer contém a lista de perfis de proteção SRTP, em ordem decrescente de preferência.
SECBUFFER_STREAM_HEADER
7 (0x7)
 O buffer contém um cabeçalho específico do protocolo para um registro específico. Normalmente, não é de interesse dos chamadores.
SECBUFFER_STREAM_TRAILER
6 (0x6)
 O buffer contém um trailer específico do protocolo para um registro específico. Normalmente, não é de interesse dos chamadores.
SECBUFFER_TARGET
13 (0xD)
 Esse sinalizador é reservado. Não o use.
SECBUFFER_TARGET_HOST
16 (0x10)
 O buffer especifica o SPN ( nome da entidade de serviço ) do destino.

Esse valor é compatível com o pacote de segurança Digest quando usado com associações de canal.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor.
SECBUFFER_TOKEN
2 (0x2)
 O buffer contém a parte do token de segurança da mensagem. Isso é somente leitura para parâmetros de entrada ou leitura/gravação para parâmetros de saída.
SECBUFFER_TOKEN_BINDING
21 (0x15)
 O buffer contém a versão do protocolo de associação de token com suporte e os parâmetros de chave, em ordem decrescente de preferência.
SECBUFFER_APPLICATION_PROTOCOLS
18
 O buffer contém uma lista de IDs de protocolo de aplicativo, uma lista por tipo de extensão de negociação de protocolo de aplicativo a ser habilitada.
 

Além disso, BufferType pode combinar os sinalizadores a seguir com qualquer um dos sinalizadores na tabela anterior usando uma operação OR bit a bit.

Valor Significado
SECBUFFER_READONLY
2147483648 (0x80000000)
 O buffer é somente leitura sem soma de verificação. Esse sinalizador destina-se ao envio de informações de cabeçalho para o pacote de segurança para calcular a soma de verificação. O pacote pode ler esse buffer, mas não pode modificá-lo.
SECBUFFER_READONLY_WITH_CHECKSUM
268435456 (0x10000000)
 O buffer é somente leitura com uma soma de verificação.

pvBuffer

Um ponteiro para um buffer.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Cabeçalho sspi.h (inclua Security.h)

Confira também

Secbufferdesc