Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

5.43 DRS_SecBuffer

DRS_SecBuffer is a concrete type for a buffer that contains authentication data.

typedef struct {
  [range(0,10000)] unsigned long cbBuffer;
  unsigned long BufferType;
  [size_is(cbBuffer)] BYTE* pvBuffer;
} DRS_SecBuffer;

cbBuffer: The size, in bytes, of the pvBuffer array.

BufferType: A bit field, presented in little-endian byte order, that contains the following values:

0 1 2 3 4 5 6 7 8 9 10 1 2 3 4 5 6 7 8 9 20 1 2 3 4 5 6 7 8 9 30 1

X

X

X

X

X

T

Y

P

X

X

X

X

X

X

X

X

X

X

X

X

X

X

X

X

X

X

R

O

X

X

X

X

X

X

X

X: Unused. MUST be zero and ignored.

TYP: May be one of the following values:

Value Meaning

SECBUFFER_EMPTY
0x00000000

A placeholder in the buffer array. The caller can supply several such entries in the array, and the security package can return data in them.

SECBUFFER_DATA
0x00000001

Used for common data. The security package can read this data and write it, for example, to encrypt some or all of it.

SECBUFFER_TOKEN
0x00000002

This buffer is used to indicate the security token portion of the message. This is read-only for input parameters or read/write for output parameters.

SECBUFFER_PKG_PARAMS
0x00000003

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.

SECBUFFER_MISSING
0x00000004

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.

SECBUFFER_EXTRA
0x00000005

The security package uses this value to indicate the number of extra or unprocessed bytes in a message.

SECBUFFER_STREAM_TRAILER
0x00000006

Indicates a protocol-specific trailer for a particular record.

SECBUFFER_STREAM_HEADER
0x00000007

Indicates a protocol-specific header for a particular record.

RO (SECBUFFER_READONLY, 0x80000000): The buffer is read-only. This flag is intended for sending header data to the security package for checksumming. The package can read this buffer but cannot modify it.

pvBuffer: Authentication data.

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.