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 |
|---|---|
|
Il buffer contiene un messaggio di avviso. |
|
Il buffer contiene una maschera di bit per un buffer SECBUFFER_READONLY_WITH_CHECKSUM. |
|
Il buffer contiene informazioni sull'associazione del canale. |
|
Il buffer contiene una struttura DOMAIN_PASSWORD_INFORMATION . |
|
Il buffer contiene dati comuni. Il pacchetto di sicurezza può leggere e scrivere questi dati, ad esempio per crittografare alcuni o tutti. |
|
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. |
|
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. |
|
Il pacchetto di sicurezza usa questo valore per indicare il numero di byte aggiuntivi o non elaborati in un messaggio. |
|
Il buffer contiene un elenco specifico del protocollo degli identificatori di oggetto (OID). Di solito non è di interesse per i chiamanti. |
|
Il buffer contiene una firma di un buffer SECBUFFER_MECHLIST . Di solito non è di interesse per i chiamanti. |
|
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. |
|
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. |
|
Il buffer contiene la chiave precondivisa. La dimensione massima consentita del buffer PSK è di 256 byte. |
|
Il buffer contiene l'identità della chiave precondivisa. |
|
Il buffer contiene l'identificatore di chiave master SRTP. |
|
Il buffer contiene l'elenco dei profili di protezione SRTP, in ordine decrescente di preferenza. |
|
Il buffer contiene un'intestazione specifica del protocollo per un determinato record. Di solito non è di interesse per i chiamanti. |
|
Il buffer contiene un trailer specifico del protocollo per un determinato record. Di solito non è di interesse per i chiamanti. |
|
Questo flag è riservato. Non usarlo. |
|
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. |
|
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. |
|
Il buffer contiene la versione supportata del protocollo di associazione di token e i parametri chiave, in ordine decrescente di preferenza. |
|
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.
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) |