Struttura SecBuffer (sspi.h)

La struttura SecBuffer descrive un buffer allocato da un'applicazione di trasporto da passare a un pacchetto di sicurezza.

Sintassi

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

Members

cbBuffer

Specifica le dimensioni, in byte, del buffer a cui punta il membro pvBuffer .

BufferType

Flag di bit che indicano il tipo di buffer. BufferType deve essere uno dei flag seguenti.

Valore Significato
SECBUFFER_ALERT
17 (0x11)
Il buffer contiene un messaggio di avviso.
SECBUFFER_ATTRMASK
4026531840 (0xF0000000)
Il buffer contiene una maschera di bit per un buffer SECBUFFER_READONLY_WITH_CHECKSUM.
SECBUFFER_CHANNEL_BINDINGS
14 (0xE)
Il buffer contiene informazioni sull'associazione del canale.
SECBUFFER_CHANGE_PASS_RESPONSE
15 (0xF)
Il buffer contiene una struttura DOMAIN_PASSWORD_INFORMATION .
SECBUFFER_DATA
1 (0x1)
Il buffer contiene dati comuni. Il pacchetto di sicurezza può leggere e scrivere questi dati, ad esempio per crittografare alcuni o tutti.
SECBUFFER_DTLS_MTU
24 (0x18)
Il buffer contiene l'impostazione per la dimensione massima dell'unità di trasmissione (MTU) solo per DTLS. Il valore predefinito è 1096 e l'intervallo configurabile valido è compreso tra 200 e 64*1024.
SECBUFFER_EMPTY
0 (0x0)
Si tratta di un segnaposto nella matrice di buffer. Il chiamante può fornire diverse voci di questo tipo nella matrice e il pacchetto di sicurezza può restituire le informazioni in esse contenute. Per altre informazioni, vedere Semantica del contesto SSPI.
SECBUFFER_EXTRA
5 (0x5)
Il pacchetto di sicurezza usa questo valore per indicare il numero di byte aggiuntivi o non elaborati in un messaggio.
SECBUFFER_MECHLIST
11 (0xB)
Il buffer contiene un elenco specifico del protocollo degli identificatori di oggetto (OID). Di solito non è di interesse per i chiamanti.
SECBUFFER_MECHLIST_SIGNATURE
12 (0xC)
Il buffer contiene una firma di un buffer SECBUFFER_MECHLIST . Di solito non è di interesse per i chiamanti.
SECBUFFER_MISSING
4 (0x4)
Il pacchetto di sicurezza usa questo valore per indicare il numero di byte mancanti in un determinato messaggio. Il membro pvBuffer viene ignorato in questo tipo.
SECBUFFER_PKG_PARAMS
3 (0x3)
Si tratta di parametri specifici del trasporto a pacchetto. Ad esempio, il redirector NetWare può fornire l'identificatore dell'oggetto server, mentre DCE RPC può fornire un UUID di associazione e così via.
SECBUFFER_PRESHARED_KEY
22 (0x16)
Il buffer contiene la chiave precondivisa. La dimensione massima consentita del buffer PSK è di 256 byte.
SECBUFFER_PRESHARED_KEY_IDENTITY
23 (0x17)
Il buffer contiene l'identità della chiave precondivisa.
SECBUFFER_SRTP_MASTER_KEY_IDENTIFIER
20 (0x14)
Il buffer contiene l'identificatore di chiave master SRTP.
SECBUFFER_SRTP_PROTECTION_PROFILES
19 (0x13)
Il buffer contiene l'elenco dei profili di protezione SRTP, in ordine decrescente di preferenza.
SECBUFFER_STREAM_HEADER
7 (0x7)
Il buffer contiene un'intestazione specifica del protocollo per un determinato record. Di solito non è di interesse per i chiamanti.
SECBUFFER_STREAM_TRAILER
6 (0x6)
Il buffer contiene un trailer specifico del protocollo per un determinato record. Di solito non è di interesse per i chiamanti.
SECBUFFER_TARGET
13 (0xD)
Questo flag è riservato. Non usarlo.
SECBUFFER_TARGET_HOST
16 (0x10)
Il buffer specifica il nome dell'entità servizio (SPN) della destinazione.

Questo valore è supportato dal pacchetto di sicurezza Digest quando viene usato con le associazioni di canale.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato.

SECBUFFER_TOKEN
2 (0x2)
Il buffer contiene la parte del token di sicurezza del messaggio. Questa opzione è di sola lettura per i parametri di input o di lettura/scrittura per i parametri di output.
SECBUFFER_TOKEN_BINDING
21 (0x15)
Il buffer contiene la versione supportata del protocollo di associazione di token e i parametri chiave, in ordine decrescente di preferenza.
SECBUFFER_APPLICATION_PROTOCOLS
18
Il buffer contiene un elenco di ID protocollo applicazione, un elenco per ogni tipo di estensione di negoziazione del protocollo dell'applicazione da abilitare.
 

BufferType può inoltre combinare i flag seguenti con uno qualsiasi dei flag nella tabella precedente usando un'operazione OR bit per bit.

Valore Significato
SECBUFFER_READONLY
2147483648 (0x80000000)
Il buffer è di sola lettura senza checksum. Questo flag è destinato all'invio di informazioni di intestazione al pacchetto di sicurezza per il calcolo del checksum. Il pacchetto può leggere questo buffer, ma non modificarlo.
SECBUFFER_READONLY_WITH_CHECKSUM
268435456 (0x10000000)
Il buffer è di sola lettura con un checksum.

pvBuffer

Puntatore a un buffer.

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1 [solo app desktop]
Server minimo supportato Windows Server 2012 R2 [solo app desktop]
Intestazione sspi.h (include Security.h)

Vedi anche

SecBufferDesc