Win32 API 日本語リファレンス
ホーム › Security.Cryptography › SCHANNEL_ALG

SCHANNEL_ALG

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 20 バイト / x86: 20 バイト

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

フィールド

フィールド型サイズx64x86説明
dwUseDWORD4+0+0

派生キーの用途を示します。次の値を使用できます。

値 意味
SCHANNEL_MAC_KEY
 SSL MAC 署名の作成または検証を行うためのキーを派生します。
SCHANNEL_ENC_KEY
 データの暗号化または復号を行うためのキーを派生します。
AlgidALG_ID4+4+4

派生キーで使用されるアルゴリズムです。事前に列挙によって CSP から取得したものでない限り、アルゴリズムは指定されないことに注意してください。

SCHANNEL_MAC_KEY には MD5 または SHA を指定できます。

SCHANNEL_ENC_KEY には RC4、DES、3DES、または RC2 を指定できます。

cBitsDWORD4+8+8派生キーのサイズ (ビット単位) です。
dwFlagsDWORD4+12+12このフラグには INTERNATIONAL_USAGE (0x00000001) を設定できます。これは、派生キーが SSL のエクスポート規則に従う必要があることを示します。
dwReservedDWORD4+16+16将来の使用のために予約済みです。0 に設定してください。

公式ドキュメント

SCHANNEL_ALG 構造体は、アルゴリズムとキーサイズの情報を格納します。dwParam に KP_SCHANNEL_ALG を設定して CryptSetKeyParam を呼び出す際に、pbData として渡される構造体として使用されます。

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

各言語での定義

#include <windows.h>

// SCHANNEL_ALG  (x64 20 / x86 20 バイト)
typedef struct SCHANNEL_ALG {
    DWORD dwUse;
    ALG_ID Algid;
    DWORD cBits;
    DWORD dwFlags;
    DWORD dwReserved;
} SCHANNEL_ALG;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SCHANNEL_ALG
{
    public uint dwUse;
    public uint Algid;
    public uint cBits;
    public uint dwFlags;
    public uint dwReserved;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SCHANNEL_ALG
    Public dwUse As UInteger
    Public Algid As UInteger
    Public cBits As UInteger
    Public dwFlags As UInteger
    Public dwReserved As UInteger
End Structure
import ctypes
from ctypes import wintypes

class SCHANNEL_ALG(ctypes.Structure):
    _fields_ = [
        ("dwUse", wintypes.DWORD),
        ("Algid", wintypes.DWORD),
        ("cBits", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("dwReserved", wintypes.DWORD),
    ]
#[repr(C)]
pub struct SCHANNEL_ALG {
    pub dwUse: u32,
    pub Algid: u32,
    pub cBits: u32,
    pub dwFlags: u32,
    pub dwReserved: u32,
}
import "golang.org/x/sys/windows"

type SCHANNEL_ALG struct {
	dwUse uint32
	Algid uint32
	cBits uint32
	dwFlags uint32
	dwReserved uint32
}
type
  SCHANNEL_ALG = record
    dwUse: DWORD;
    Algid: DWORD;
    cBits: DWORD;
    dwFlags: DWORD;
    dwReserved: DWORD;
  end;
const SCHANNEL_ALG = extern struct {
    dwUse: u32,
    Algid: u32,
    cBits: u32,
    dwFlags: u32,
    dwReserved: u32,
};
type
  SCHANNEL_ALG {.bycopy.} = object
    dwUse: uint32
    Algid: uint32
    cBits: uint32
    dwFlags: uint32
    dwReserved: uint32
struct SCHANNEL_ALG
{
    uint dwUse;
    uint Algid;
    uint cBits;
    uint dwFlags;
    uint dwReserved;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SCHANNEL_ALG サイズ: 20 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; dwUse : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Algid : ALG_ID (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; cBits : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwFlags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwReserved : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SCHANNEL_ALG
    #field int dwUse
    #field int Algid
    #field int cBits
    #field int dwFlags
    #field int dwReserved
#endstruct

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