SecBuffer structure (sspi.h)
The SecBuffer structure describes a buffer allocated by a transport application to pass to a security package.
Syntax
typedef struct _SecBuffer {
unsigned long cbBuffer;
unsigned long BufferType;
#if ...
char *pvBuffer;
#else
void SEC_FAR *pvBuffer;
#endif
} SecBuffer, *PSecBuffer;
Members
cbBuffer
Specifies the size, in bytes, of the buffer pointed to by the pvBuffer member.
BufferType
Bit flags that indicate the type of buffer. BufferType must be one of the following flags.
| Value | Meaning |
|---|---|
|
The buffer contains an alert message. |
|
The buffer contains a bitmask for a SECBUFFER_READONLY_WITH_CHECKSUM buffer. |
|
The buffer contains channel binding information. |
|
The buffer contains a DOMAIN_PASSWORD_INFORMATION structure. |
|
The buffer contains common data. The security package can read and write this data, for example, to encrypt some or all of it. |
|
The buffer contains the setting for the maximum transmission unit (MTU) size for DTLS only. The default value is 1096 and the valid configurable range is between 200 and 64*1024. |
|
This is a placeholder in the buffer array. The caller can supply several such entries in the array, and the security package can return information in them. For more information, see SSPI Context Semantics. |
|
The security package uses this value to indicate the number of extra or unprocessed bytes in a message. |
|
The buffer contains a protocol-specific list of object identifiers (OIDs). It is not usually of interest to callers. |
|
The buffer contains a signature of a SECBUFFER_MECHLIST buffer. It is not usually of interest to callers. |
|
The security package uses this value to indicate the number of missing bytes in a particular message. The pvBuffer member is ignored in this type. |
|
These are transport-to-package–specific parameters. For example, the NetWare redirector may supply the server object identifier, while DCE RPC can supply an association UUID, and so on. |
|
The buffer contains the preshared key. The maximum allowed PSK buffer size is 256 bytes. |
|
The buffer contains the preshared key identity. |
|
The buffer contains the SRTP master key identifier. |
|
The buffer contains the list of SRTP protection profiles, in descending order of preference. |
|
The buffer contains a protocol-specific header for a particular record. It is not usually of interest to callers. |
|
The buffer contains a protocol-specific trailer for a particular record. It is not usually of interest to callers. |
|
This flag is reserved. Do not use it. |
|
The buffer specifies the service principal name (SPN) of the target.
This value is supported by the Digest security package when used with channel bindings. Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP: This value is not supported. |
|
The buffer contains the security token portion of the message. This is read-only for input parameters or read/write for output parameters. |
|
The buffer contains the supported token binding protocol version and key parameters, in descending order of preference. |
|
The buffer contains a list of application protocol IDs, one list per application protocol negotiation extension type to be enabled. |
In addition, BufferType can combine the following flags with any of the flags in the preceding table by using a bitwise-OR operation.
pvBuffer
A pointer to a buffer.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8.1 [desktop apps only] |
| Minimum supported server | Windows Server 2012 R2 [desktop apps only] |
| Header | sspi.h (include Security.h) |