Estructura SecBuffer (sspi.h)

La estructura SecBuffer describe un búfer asignado por una aplicación de transporte para pasar a un paquete de seguridad.

Sintaxis

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

Miembros

cbBuffer

Especifica el tamaño, en bytes, del búfer al que apunta el miembro pvBuffer .

BufferType

Marcas de bits que indican el tipo de búfer. BufferType debe ser una de las siguientes marcas.

Valor Significado
SECBUFFER_ALERT
17 (0x11)
El búfer contiene un mensaje de alerta.
SECBUFFER_ATTRMASK
4026531840 (0xF0000000)
El búfer contiene una máscara de bits para un búfer de SECBUFFER_READONLY_WITH_CHECKSUM.
SECBUFFER_CHANNEL_BINDINGS
14 (0xE)
El búfer contiene información de enlace de canal.
SECBUFFER_CHANGE_PASS_RESPONSE
15 (0xF)
El búfer contiene una estructura de DOMAIN_PASSWORD_INFORMATION .
SECBUFFER_DATA
1 (0x1)
El búfer contiene datos comunes. El paquete de seguridad puede leer y escribir estos datos, por ejemplo, para cifrar algunos o todos ellos.
SECBUFFER_DTLS_MTU
24 (0x18)
El búfer contiene la configuración del tamaño máximo de la unidad de transmisión (MTU) solo para DTLS. El valor predeterminado es 1096 y el intervalo configurable válido está comprendido entre 200 y 64*1024.
SECBUFFER_EMPTY
0 (0x0)
Se trata de un marcador de posición en la matriz de búfer. El autor de la llamada puede proporcionar varias entradas de este tipo en la matriz y el paquete de seguridad puede devolver información en ellos. Para obtener más información, consulte Semántica de contexto de SSPI.
SECBUFFER_EXTRA
5 (0x5)
El paquete de seguridad usa este valor para indicar el número de bytes adicionales o no procesados en un mensaje.
SECBUFFER_MECHLIST
11 (0xB)
El búfer contiene una lista específica del protocolo de identificadores de objeto (OID). Normalmente no es de interés para los autores de llamadas.
SECBUFFER_MECHLIST_SIGNATURE
12 (0xC)
El búfer contiene una firma de un búfer de SECBUFFER_MECHLIST . Normalmente no es de interés para los autores de llamadas.
SECBUFFER_MISSING
4 (0x4)
El paquete de seguridad usa este valor para indicar el número de bytes que faltan en un mensaje determinado. El miembro pvBuffer se omite en este tipo.
SECBUFFER_PKG_PARAMS
3 (0x3)
Estos son parámetros específicos del transporte al paquete. Por ejemplo, el redirector de NetWare puede proporcionar el identificador de objeto de servidor, mientras que DCE RPC puede proporcionar un UUID de asociación, etc.
SECBUFFER_PRESHARED_KEY
22 (0x16)
El búfer contiene la clave precompartida. El tamaño máximo permitido del búfer de PSK es de 256 bytes.
SECBUFFER_PRESHARED_KEY_IDENTITY
23 (0x17)
El búfer contiene la identidad de clave precompartida.
SECBUFFER_SRTP_MASTER_KEY_IDENTIFIER
20 (0x14)
El búfer contiene el identificador de clave maestra SRTP.
SECBUFFER_SRTP_PROTECTION_PROFILES
19 (0x13)
El búfer contiene la lista de perfiles de protección SRTP, en orden descendente de preferencia.
SECBUFFER_STREAM_HEADER
7 (0x7)
El búfer contiene un encabezado específico del protocolo para un registro determinado. Normalmente no es de interés para los autores de llamadas.
SECBUFFER_STREAM_TRAILER
6 (0x6)
El búfer contiene un finalizador específico del protocolo para un registro determinado. Normalmente no es de interés para los autores de llamadas.
SECBUFFER_TARGET
13 (0xD)
Esta marca está reservada. No lo utilice.
SECBUFFER_TARGET_HOST
16 (0x10)
El búfer especifica el nombre de entidad de seguridad de servicio (SPN) del destino.

Este valor es compatible con el paquete de seguridad Digest cuando se usa con enlaces de canal.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite.

SECBUFFER_TOKEN
2 (0x2)
El búfer contiene la parte del token de seguridad del mensaje. Esto es de solo lectura para los parámetros de entrada o de lectura y escritura para los parámetros de salida.
SECBUFFER_TOKEN_BINDING
21 (0x15)
El búfer contiene la versión del protocolo de enlace de tokens y los parámetros clave admitidos, en orden descendente de preferencia.
SECBUFFER_APPLICATION_PROTOCOLS
18
El búfer contiene una lista de identificadores de protocolo de aplicación, una lista por tipo de extensión de negociación de protocolo de aplicación que se va a habilitar.
 

Además, BufferType puede combinar las marcas siguientes con cualquiera de las marcas de la tabla anterior mediante una operación OR bit a bit.

Valor Significado
SECBUFFER_READONLY
2147483648 (0x80000000)
El búfer es de solo lectura sin suma de comprobación. Esta marca está pensada para enviar información de encabezado al paquete de seguridad para calcular la suma de comprobación. El paquete puede leer este búfer, pero no puede modificarlo.
SECBUFFER_READONLY_WITH_CHECKSUM
268435456 (0x10000000)
El búfer es de solo lectura con una suma de comprobación.

pvBuffer

Puntero a un búfer.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 R2 [solo aplicaciones de escritorio]
Encabezado sspi.h (include Security.h)

Consulte también

SecBufferDesc