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 |
|---|---|
|
Der Puffer enthält eine Warnmeldung. |
|
Der Puffer enthält eine Bitmaske für einen SECBUFFER_READONLY_WITH_CHECKSUM Puffer. |
|
Der Puffer enthält Informationen zur Kanalbindung. |
|
Der Puffer enthält eine DOMAIN_PASSWORD_INFORMATION-Struktur . |
|
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. |
|
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. |
|
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. |
|
Das Sicherheitspaket verwendet diesen Wert, um die Anzahl der zusätzlichen oder nicht verarbeiteten Bytes in einer Nachricht anzugeben. |
|
Der Puffer enthält eine protokollspezifische Liste von Objektbezeichnern (Object Identifiers , OIDs). Es ist in der Regel nicht von Interesse für Anrufer. |
|
Der Puffer enthält eine Signatur eines SECBUFFER_MECHLIST Puffers. Es ist in der Regel nicht von Interesse für Anrufer. |
|
Das Sicherheitspaket verwendet diesen Wert, um die Anzahl der fehlenden Bytes in einer bestimmten Nachricht anzugeben. Der pvBuffer-Member wird in diesem Typ ignoriert. |
|
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. |
|
Der Puffer enthält den vorab freigegebenen Schlüssel. Die maximal zulässige PSK-Puffergröße beträgt 256 Bytes. |
|
Der Puffer enthält die vorab freigegebene Schlüsselidentität. |
|
Der Puffer enthält den SRTP-master Schlüsselbezeichner. |
|
Der Puffer enthält die Liste der SRTP-Schutzprofile in absteigender Reihenfolge der Einstellungen. |
|
Der Puffer enthält einen protokollspezifischen Header für einen bestimmten Datensatz. Es ist in der Regel nicht von Interesse für Anrufer. |
|
Der Puffer enthält einen protokollspezifischen Trailer für einen bestimmten Datensatz. Es ist in der Regel nicht von Interesse für Anrufer. |
|
Dieses Flag ist reserviert. Verwenden Sie sie nicht. |
|
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. |
|
Der Puffer enthält den Sicherheitstokenteil der Nachricht. Dies ist schreibgeschützt für Eingabeparameter oder Lese-/Schreibzugriff für Ausgabeparameter. |
|
Der Puffer enthält die unterstützte Tokenbindungsprotokollversion und schlüsselparameter in absteigender Reihenfolge der Einstellung. |
|
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.
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) |