ホーム › Security.Authentication.Identity › SecPkgContext_StreamSizes

SecPkgContext_StreamSizes

構造体

サイズx64: 20 バイト / x86: 20 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド	型	サイズ	x64	x86	説明
cbHeader	DWORD	4	+0	+0	ヘッダー部分のサイズをバイト単位で指定します。0 の場合、ヘッダーは使用されません。
cbTrailer	DWORD	4	+4	+4	トレーラー部分の最大サイズをバイト単位で指定します。0 の場合、トレーラーは使用されません。
cbMaximumMessage	DWORD	4	+8	+8	カプセル化できる最大のメッセージのサイズをバイト単位で指定します。
cBuffers	DWORD	4	+12	+12	渡すバッファーの数を指定します。
cbBlockSize	DWORD	4	+16	+16	メッセージの推奨される整数サイズを指定します。たとえば 8 は、最適なパフォーマンスを得るためにメッセージのサイズが 8 の倍数 (8 で割った剰余が 0) であるべきことを示します。このブロックサイズ以外のメッセージはパディングされることがあります。

公式ドキュメント

SecPkgContext_StreamSizes 構造体は、メッセージサポート関数で使用するストリームの各部分のサイズを示します。 QueryContextAttributes (General) 関数はこの構造体を使用します。

解説(Remarks)

EncryptMessage (General) を呼び出すアプリケーションは、暗号化されたパケットのサイズを判断するために cbHeader、cbTrailer、cbMaximumMessage の各メンバーの値を確認する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// SecPkgContext_StreamSizes  (x64 20 / x86 20 バイト)
typedef struct SecPkgContext_StreamSizes {
    DWORD cbHeader;
    DWORD cbTrailer;
    DWORD cbMaximumMessage;
    DWORD cBuffers;
    DWORD cbBlockSize;
} SecPkgContext_StreamSizes;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SecPkgContext_StreamSizes
{
    public uint cbHeader;
    public uint cbTrailer;
    public uint cbMaximumMessage;
    public uint cBuffers;
    public uint cbBlockSize;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SecPkgContext_StreamSizes
    Public cbHeader As UInteger
    Public cbTrailer As UInteger
    Public cbMaximumMessage As UInteger
    Public cBuffers As UInteger
    Public cbBlockSize As UInteger
End Structure

import ctypes
from ctypes import wintypes

class SecPkgContext_StreamSizes(ctypes.Structure):
    _fields_ = [
        ("cbHeader", wintypes.DWORD),
        ("cbTrailer", wintypes.DWORD),
        ("cbMaximumMessage", wintypes.DWORD),
        ("cBuffers", wintypes.DWORD),
        ("cbBlockSize", wintypes.DWORD),
    ]

#[repr(C)]
pub struct SecPkgContext_StreamSizes {
    pub cbHeader: u32,
    pub cbTrailer: u32,
    pub cbMaximumMessage: u32,
    pub cBuffers: u32,
    pub cbBlockSize: u32,
}

import "golang.org/x/sys/windows"

type SecPkgContext_StreamSizes struct {
	cbHeader uint32
	cbTrailer uint32
	cbMaximumMessage uint32
	cBuffers uint32
	cbBlockSize uint32
}

type
  SecPkgContext_StreamSizes = record
    cbHeader: DWORD;
    cbTrailer: DWORD;
    cbMaximumMessage: DWORD;
    cBuffers: DWORD;
    cbBlockSize: DWORD;
  end;

const SecPkgContext_StreamSizes = extern struct {
    cbHeader: u32,
    cbTrailer: u32,
    cbMaximumMessage: u32,
    cBuffers: u32,
    cbBlockSize: u32,
};

type
  SecPkgContext_StreamSizes {.bycopy.} = object
    cbHeader: uint32
    cbTrailer: uint32
    cbMaximumMessage: uint32
    cBuffers: uint32
    cbBlockSize: uint32

struct SecPkgContext_StreamSizes
{
    uint cbHeader;
    uint cbTrailer;
    uint cbMaximumMessage;
    uint cBuffers;
    uint cbBlockSize;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SecPkgContext_StreamSizes サイズ: 20 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; cbHeader : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; cbTrailer : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; cbMaximumMessage : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; cBuffers : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; cbBlockSize : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SecPkgContext_StreamSizes
    #field int cbHeader
    #field int cbTrailer
    #field int cbMaximumMessage
    #field int cBuffers
    #field int cbBlockSize
#endstruct

stdim st, SecPkgContext_StreamSizes        ; NSTRUCT 変数を確保
st->cbHeader = 100
mes "cbHeader=" + st->cbHeader