Estrutura SecBuffer (sspi.h)
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 |
|---|---|
|
O buffer contém uma mensagem de alerta. |
|
O buffer contém uma máscara de bits para um buffer de SECBUFFER_READONLY_WITH_CHECKSUM. |
|
O buffer contém informações de associação de canal. |
|
O buffer contém uma estrutura DOMAIN_PASSWORD_INFORMATION . |
|
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. |
|
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. |
|
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. |
|
O pacote de segurança usa esse valor para indicar o número de bytes extras ou não processados em uma mensagem. |
|
O buffer contém uma lista específica do protocolo de identificadores de objeto (OIDs). Normalmente, não é de interesse dos chamadores. |
|
O buffer contém uma assinatura de um buffer de SECBUFFER_MECHLIST . Normalmente, não é de interesse dos chamadores. |
|
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. |
|
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. |
|
O buffer contém a chave pré-compartilhada. O tamanho máximo permitido do buffer PSK é de 256 bytes. |
|
O buffer contém a identidade da chave pré-compartilhada. |
|
O buffer contém o identificador de chave master SRTP. |
|
O buffer contém a lista de perfis de proteção SRTP, em ordem decrescente de preferência. |
|
O buffer contém um cabeçalho específico do protocolo para um registro específico. Normalmente, não é de interesse dos chamadores. |
|
O buffer contém um trailer específico do protocolo para um registro específico. Normalmente, não é de interesse dos chamadores. |
|
Esse sinalizador é reservado. Não o use. |
|
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. |
|
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. |
|
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. |
|
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.
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) |