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_ALERT
17 (0x11)
緩衝區包含警示訊息。
SECBUFFER_ATTRMASK
4026531840 (0xF0000000)
緩衝區包含SECBUFFER_READONLY_WITH_CHECKSUM緩衝區的位掩碼。
SECBUFFER_CHANNEL_BINDINGS
14 (0xE)
緩衝區包含通道系結資訊。
SECBUFFER_CHANGE_PASS_RESPONSE
15 (0xF)
緩衝區包含 DOMAIN_PASSWORD_INFORMATION 結構。
SECBUFFER_DATA
1 (0x1)
緩衝區包含一般數據。 例如，安全性套件可以讀取和寫入此數據，以加密部分或全部數據。
SECBUFFER_DTLS_MTU
24 (0x18)
緩衝區包含只有 DTLS 的最大傳輸單位 (MTU) 大小設定。 默認值為 1096，有效可設定的範圍介於 200 和 64*1024 之間。
SECBUFFER_EMPTY
0 (0x0)
這是緩衝區陣列中的佔位元。 呼叫端可以在數位列中提供數個這類專案，而安全性套件可以傳回其中的資訊。 如需詳細資訊，請參閱 SSPI 內容語意。
SECBUFFER_EXTRA
5 (0x5)
安全性套件會使用這個值來指出訊息中額外或未處理的位元元組數目。
SECBUFFER_MECHLIST
11 (0xB)
緩衝區包含通訊協定特定的 物件標識符 清單， (OID) 。 呼叫端通常不感興趣。
SECBUFFER_MECHLIST_SIGNATURE
12 (0xC)
緩衝區包含 SECBUFFER_MECHLIST 緩衝區的簽章。 呼叫端通常不感興趣。
SECBUFFER_MISSING
4 (0x4)
安全性套件會使用這個值來指出特定訊息中遺漏的位元元組數目。 在這個類型中會忽略 pvBuffer 成員。
SECBUFFER_PKG_PARAMS
3 (0x3)
這些是傳輸到套件特定的參數。 例如，NetWare 重新導向器可能會提供伺服器 對象識別碼，而 DCE RPC 可以提供關聯 UUID 等等。
SECBUFFER_PRESHARED_KEY
22 (0x16)
緩衝區包含預先共用的金鑰。 允許的 PSK 緩衝區大小上限為 256 個字節。
SECBUFFER_PRESHARED_KEY_IDENTITY
23 (0x17)
緩衝區包含預先共用的金鑰識別。
SECBUFFER_SRTP_MASTER_KEY_IDENTIFIER
20 (0x14)
緩衝區包含 SRTP 主要金鑰標識碼。
SECBUFFER_SRTP_PROTECTION_PROFILES
19 (0x13)
緩衝區包含 SRTP 保護配置檔的清單，依喜好設定順序遞減。
SECBUFFER_STREAM_HEADER
7 (0x7)
緩衝區包含特定記錄的通訊協定特定標頭。 呼叫端通常不感興趣。
SECBUFFER_STREAM_TRAILER
6 (0x6)
緩衝區包含特定記錄的通訊協定特定預告片。 呼叫端通常不感興趣。
SECBUFFER_TARGET
13 (0xD)
此旗標已保留。 不要使用它。
SECBUFFER_TARGET_HOST
16 (0x10)
緩衝區會指定目標之SPN) (服務主體名稱 。

搭配通道系結使用時，摘要式安全性套件支援此值。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援這個值。
SECBUFFER_TOKEN
2 (0x2)
緩衝區包含訊息的安全性令牌部分。 這是輸入參數的唯讀，或輸出參數的讀取/寫入。
SECBUFFER_TOKEN_BINDING
21 (0x15)
緩衝區包含支援的令牌系結通訊協定版本和金鑰參數，依喜好設定的遞減順序。
SECBUFFER_APPLICATION_PROTOCOLS
18
 緩衝區包含應用程式通訊協定標識碼的清單，每個要啟用的應用程式通訊協定交涉延伸模組類型一份清單。
 

此外， BufferType 可以使用位 OR 運算，將下列旗標與上表中的任何旗標結合。

值 意義
SECBUFFER_READONLY
2147483648 (0x80000000)
緩衝區是只讀的，沒有總和檢查碼。 此旗標適用於將標頭資訊傳送至安全性套件，以計算總和檢查碼。 封裝可以讀取此緩衝區，但無法加以修改。
SECBUFFER_READONLY_WITH_CHECKSUM
268435456 (0x10000000)
緩衝區是具有總和檢查碼的唯讀。

pvBuffer

緩衝區的指標。

規格需求

需求 值
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
標頭 sspi.h (包含 Security.h)

另請參閱

SecBufferDesc