Структура SecBuffer (sspi.h)
Структура SecBuffer описывает буфер, выделенный транспортным приложением для передачи в пакет безопасности.
Синтаксис
typedef struct _SecBuffer {
unsigned long cbBuffer;
unsigned long BufferType;
#if ...
char *pvBuffer;
#else
void SEC_FAR *pvBuffer;
#endif
} SecBuffer, *PSecBuffer;
Члены
cbBuffer
Задает размер (в байтах) буфера, на который указывает член pvBuffer .
BufferType
Битовые флаги, указывающие тип буфера. BufferType должен иметь один из следующих флагов.
| Значение | Значение |
|---|---|
|
Буфер содержит оповещение. |
|
Буфер содержит битовую маску для SECBUFFER_READONLY_WITH_CHECKSUM буфера. |
|
Буфер содержит сведения о привязке канала. |
|
Буфер содержит структуру DOMAIN_PASSWORD_INFORMATION . |
|
Буфер содержит общие данные. Пакет безопасности может считывать и записывать эти данные, например, для шифрования некоторых или всех этих данных. |
|
Буфер содержит параметр максимального размера единицы передачи (MTU) только для DTLS. Значение по умолчанию — 1096, а допустимый настраиваемый диапазон — от 200 до 64*1024. |
|
Это заполнитель в буферном массиве. Вызывающий объект может предоставить несколько таких записей в массиве, а пакет безопасности может возвращать в них сведения. Дополнительные сведения см. в разделе Семантика контекста SSPI. |
|
Пакет безопасности использует это значение для указания количества дополнительных или необработанных байтов в сообщении. |
|
Буфер содержит зависящий от протокола список идентификаторов объектов (OID). Обычно это не представляет интереса для абонентов. |
|
Буфер содержит сигнатуру SECBUFFER_MECHLIST буфера. Обычно это не представляет интереса для абонентов. |
|
Пакет безопасности использует это значение, чтобы указать количество отсутствующих байтов в определенном сообщении. Элемент pvBuffer игнорируется в этом типе. |
|
Это параметры, относящиеся к транспорту в пакет. Например, перенаправитель NetWare может предоставить идентификатор объекта сервера, а DCE RPC — UUID связи и т. д. |
|
Буфер содержит общий ключ. Максимальный допустимый размер буфера PSK составляет 256 байт. |
|
Буфер содержит идентификатор общего ключа. |
|
Буфер содержит идентификатор ключа master SRTP. |
|
Буфер содержит список профилей защиты SRTP в порядке убывания предпочтения. |
|
Буфер содержит определенный заголовок протокола для определенной записи. Обычно это не представляет интереса для абонентов. |
|
Буфер содержит трейлер для определенной записи, относяющийся к протоколу. Обычно это не представляет интереса для абонентов. |
|
Этот флаг зарезервирован. Не используйте его. |
|
Буфер указывает имя субъекта-службы (SPN) целевого объекта.
Это значение поддерживается пакетом безопасности Digest при использовании с привязками каналов. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается. |
|
Буфер содержит часть маркера безопасности сообщения. Этот параметр доступен только для чтения для входных параметров или для чтения и записи для выходных параметров. |
|
Буфер содержит поддерживаемую версию протокола привязки маркеров и параметры ключа в порядке убывания предпочтения. |
|
Буфер содержит список идентификаторов протоколов приложений, по одному списку для каждого типа расширения согласования протокола приложения, который необходимо включить. |
Кроме того, BufferType может объединять следующие флаги с любым из флагов в предыдущей таблице с помощью побитовой операции ИЛИ .
pvBuffer
Указатель на буфер.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8.1 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 R2 [только классические приложения] |
| Верхняя часть | sspi.h (включая Security.h) |