Freigeben über


SecBuffer-Struktur (sspi.h)

Die SecBuffer-Struktur beschreibt einen Puffer, der von einer Transportanwendung für die Übergabe an ein Sicherheitspaket zugewiesen wird.

Syntax

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

Member

cbBuffer

Gibt die Größe des Puffers in Bytes an, auf den der pvBuffer-Member verweist.

BufferType

Bitflags, die den Typ des Puffers angeben. BufferType muss eines der folgenden Flags sein.

Wert Bedeutung
SECBUFFER_ALERT
17 (0x11)
Der Puffer enthält eine Warnmeldung.
SECBUFFER_ATTRMASK
4026531840 (0xF0000000)
Der Puffer enthält eine Bitmaske für einen SECBUFFER_READONLY_WITH_CHECKSUM Puffer.
SECBUFFER_CHANNEL_BINDINGS
14 (0xE)
Der Puffer enthält Informationen zur Kanalbindung.
SECBUFFER_CHANGE_PASS_RESPONSE
15 (0xF)
Der Puffer enthält eine DOMAIN_PASSWORD_INFORMATION-Struktur .
SECBUFFER_DATA
1 (0x1)
Der Puffer enthält allgemeine Daten. Das Sicherheitspaket kann diese Daten lesen und schreiben, z. B. um einen Teil oder alle daten zu verschlüsseln.
SECBUFFER_DTLS_MTU
24 (0x18)
Der Puffer enthält die Einstellung für die maximale Mtu-Größe (Transmission Unit) nur für DTLS. Der Standardwert ist 1096, und der gültige konfigurierbare Bereich liegt zwischen 200 und 64*1024.
SECBUFFER_EMPTY
0 (0x0)
Dies ist ein Platzhalter im Pufferarray. Der Aufrufer kann mehrere solche Einträge im Array bereitstellen, und das Sicherheitspaket kann darin Enthaltene Informationen zurückgeben. Weitere Informationen finden Sie unter SSPI-Kontextsemantik.
SECBUFFER_EXTRA
5 (0x5)
Das Sicherheitspaket verwendet diesen Wert, um die Anzahl der zusätzlichen oder nicht verarbeiteten Bytes in einer Nachricht anzugeben.
SECBUFFER_MECHLIST
11 (0xB)
Der Puffer enthält eine protokollspezifische Liste von Objektbezeichnern (Object Identifiers , OIDs). Es ist in der Regel nicht von Interesse für Anrufer.
SECBUFFER_MECHLIST_SIGNATURE
12 (0xC)
Der Puffer enthält eine Signatur eines SECBUFFER_MECHLIST Puffers. Es ist in der Regel nicht von Interesse für Anrufer.
SECBUFFER_MISSING
4 (0x4)
Das Sicherheitspaket verwendet diesen Wert, um die Anzahl der fehlenden Bytes in einer bestimmten Nachricht anzugeben. Der pvBuffer-Member wird in diesem Typ ignoriert.
SECBUFFER_PKG_PARAMS
3 (0x3)
Hierbei handelt es sich um transport-to-package-spezifische Parameter. Beispielsweise kann der NetWare-Redirector den Serverobjektbezeichner bereitstellen, während DCE RPC eine Zuordnungs-UUID bereitstellen kann usw.
SECBUFFER_PRESHARED_KEY
22 (0x16)
Der Puffer enthält den vorab freigegebenen Schlüssel. Die maximal zulässige PSK-Puffergröße beträgt 256 Bytes.
SECBUFFER_PRESHARED_KEY_IDENTITY
23 (0x17)
Der Puffer enthält die vorab freigegebene Schlüsselidentität.
SECBUFFER_SRTP_MASTER_KEY_IDENTIFIER
20 (0x14)
Der Puffer enthält den SRTP-master Schlüsselbezeichner.
SECBUFFER_SRTP_PROTECTION_PROFILES
19 (0x13)
Der Puffer enthält die Liste der SRTP-Schutzprofile in absteigender Reihenfolge der Einstellungen.
SECBUFFER_STREAM_HEADER
7 (0x7)
Der Puffer enthält einen protokollspezifischen Header für einen bestimmten Datensatz. Es ist in der Regel nicht von Interesse für Anrufer.
SECBUFFER_STREAM_TRAILER
6 (0x6)
Der Puffer enthält einen protokollspezifischen Trailer für einen bestimmten Datensatz. Es ist in der Regel nicht von Interesse für Anrufer.
SECBUFFER_TARGET
13 (0xD)
Dieses Flag ist reserviert. Verwenden Sie sie nicht.
SECBUFFER_TARGET_HOST
16 (0x10)
Der Puffer gibt den Dienstprinzipalnamen (Service Principal Name , SPN) des Ziels an.

Dieser Wert wird vom Digest-Sicherheitspaket unterstützt, wenn er mit Kanalbindungen verwendet wird.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.

SECBUFFER_TOKEN
2 (0x2)
Der Puffer enthält den Sicherheitstokenteil der Nachricht. Dies ist schreibgeschützt für Eingabeparameter oder Lese-/Schreibzugriff für Ausgabeparameter.
SECBUFFER_TOKEN_BINDING
21 (0x15)
Der Puffer enthält die unterstützte Tokenbindungsprotokollversion und schlüsselparameter in absteigender Reihenfolge der Einstellung.
SECBUFFER_APPLICATION_PROTOCOLS
18
Der Puffer enthält eine Liste der Anwendungsprotokoll-IDs, wobei eine Liste pro zu aktivierenden Anwendungsprotokollaushandlungserweiterungstyp enthalten ist.
 

Darüber hinaus kann BufferType die folgenden Flags mithilfe eines bitweisen OR-Vorgangs mit einem der Flags in der vorherigen Tabelle kombinieren.

Wert Bedeutung
SECBUFFER_READONLY
2147483648 (0x80000000)
Der Puffer ist schreibgeschützt ohne Prüfsumme. Dieses Flag dient zum Senden von Headerinformationen an das Sicherheitspaket zum Berechnen der Prüfsumme. Das Paket kann diesen Puffer lesen, aber nicht ändern.
SECBUFFER_READONLY_WITH_CHECKSUM
268435456 (0x10000000)
Der Puffer ist schreibgeschützt mit einer Prüfsumme.

pvBuffer

Ein Zeiger auf einen Puffer.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [nur Desktop-Apps]
Kopfzeile sspi.h (einschließlich Security.h)

Weitere Informationen

SecBufferDesc