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 構造体が含まれています。 |
|
バッファーには共通データが含まれています。 セキュリティ パッケージでは、このデータの一部またはすべてを暗号化するために、このデータの読み取りと書き込みを行うことができます。 |
|
バッファーには、DTLS のみの最大伝送単位 (MTU) サイズの設定が含まれています。 既定値は 1096 で、有効な構成可能範囲は 200 ~ 64*1024 です。 |
|
これはバッファー配列のプレースホルダーです。 呼び出し元は配列にこのようなエントリをいくつか指定でき、セキュリティ パッケージはそれらの中の情報を返すことができます。 詳細については、「 SSPI コンテキスト セマンティクス」を参照してください。 |
|
セキュリティ パッケージでは、この値を使用して、メッセージ内の余分または未処理のバイト数を示します。 |
|
バッファーには、プロトコル固有の オブジェクト識別子 (OID) の一覧が含まれています。 通常、呼び出し元には関心がありません。 |
|
バッファーには、 SECBUFFER_MECHLIST バッファーのシグネチャが含まれています。 通常、呼び出し元には関心がありません。 |
|
セキュリティ パッケージでは、この値を使用して、特定のメッセージに不足しているバイト数を示します。 この型では 、pvBuffer メンバーは無視されます。 |
|
これらは、トランスポートからパッケージへの固有のパラメーターです。 たとえば、NetWare リダイレクターはサーバー オブジェクト識別子を指定し、DCE RPC では関連付け UUID などを指定できます。 |
|
バッファーには、事前共有キーが含まれています。 許容される PSK バッファー の最大サイズは 256 バイトです。 |
|
バッファーには、事前共有キー ID が含まれています。 |
|
バッファーには、SRTP マスター キー識別子が含まれています。 |
|
バッファーには、優先順位の降順で SRTP 保護プロファイルの一覧が含まれています。 |
|
バッファーには、特定のレコードのプロトコル固有のヘッダーが含まれています。 通常、呼び出し元には関心がありません。 |
|
バッファーには、特定のレコードのプロトコル固有のトレーラーが含まれています。 通常、呼び出し元には関心がありません。 |
|
このフラグは予約されています。 使用しないでください。 |
|
バッファーは、ターゲットの サービス プリンシパル名 (SPN) を指定します。
この値は、チャネル バインドと共に使用する場合、Digest セキュリティ パッケージでサポートされます。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値はサポートされていません。 |
|
バッファーには、メッセージのセキュリティ トークン部分が含まれています。 これは、入力パラメーターの場合は読み取り専用、出力パラメーターの場合は読み取り/書き込みです。 |
|
バッファーには、サポートされているトークン バインド プロトコルのバージョンとキー パラメーターが、優先順位の降順で含まれています。 |
|
バッファーには、アプリケーション プロトコル ID の一覧が含まれています。有効にするアプリケーション プロトコル ネゴシエーション拡張機能の種類ごとに 1 つのリストです。 |
さらに、 BufferType では、ビットごとの OR 演算を使用して、次のフラグを前の表の任意のフラグと組み合わせることができます。
pvBuffer
バッファーへのポインター。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8.1 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 R2 [デスクトップ アプリのみ] |
| Header | sspi.h (Security.h を含む) |