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

BCRYPT_CIPHER_FUNCTION_TABLE

構造体
サイズx64: 96 バイト / x86: 48 バイト

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

フィールド

フィールドサイズx64x86説明
VersionBCRYPT_INTERFACE_VERSION4+0+0CNG暗号インターフェイスのバージョン。
OpenAlgorithmProviderBCryptOpenAlgorithmProviderFn8/4+8+4アルゴリズムプロバイダーを開く関数ポインタ。
GetPropertyBCryptGetPropertyFn8/4+16+8プロパティを取得する関数ポインタ。
SetPropertyBCryptSetPropertyFn8/4+24+12プロパティを設定する関数ポインタ。
CloseAlgorithmProviderBCryptCloseAlgorithmProviderFn8/4+32+16アルゴリズムプロバイダーを閉じる関数ポインタ。
GenerateKeyBCryptGenerateSymmetricKeyFn8/4+40+20対称鍵を生成する関数ポインタ。
EncryptBCryptEncryptFn8/4+48+24暗号化を行う関数ポインタ。
DecryptBCryptDecryptFn8/4+56+28復号を行う関数ポインタ。
ImportKeyBCryptImportKeyFn8/4+64+32鍵をインポートする関数ポインタ。
ExportKeyBCryptExportKeyFn8/4+72+36鍵をエクスポートする関数ポインタ。
DuplicateKeyBCryptDuplicateKeyFn8/4+80+40鍵を複製する関数ポインタ。
DestroyKeyBCryptDestroyKeyFn8/4+88+44鍵を破棄する関数ポインタ。

各言語での定義

#include <windows.h>

// BCRYPT_INTERFACE_VERSION  (x64 4 / x86 4 バイト)
typedef struct BCRYPT_INTERFACE_VERSION {
    WORD MajorVersion;
    WORD MinorVersion;
} BCRYPT_INTERFACE_VERSION;

// BCRYPT_CIPHER_FUNCTION_TABLE  (x64 96 / x86 48 バイト)
typedef struct BCRYPT_CIPHER_FUNCTION_TABLE {
    BCRYPT_INTERFACE_VERSION Version;
    BCryptOpenAlgorithmProviderFn OpenAlgorithmProvider;
    BCryptGetPropertyFn GetProperty;
    BCryptSetPropertyFn SetProperty;
    BCryptCloseAlgorithmProviderFn CloseAlgorithmProvider;
    BCryptGenerateSymmetricKeyFn GenerateKey;
    BCryptEncryptFn Encrypt;
    BCryptDecryptFn Decrypt;
    BCryptImportKeyFn ImportKey;
    BCryptExportKeyFn ExportKey;
    BCryptDuplicateKeyFn DuplicateKey;
    BCryptDestroyKeyFn DestroyKey;
} BCRYPT_CIPHER_FUNCTION_TABLE;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BCRYPT_INTERFACE_VERSION
{
    public ushort MajorVersion;
    public ushort MinorVersion;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BCRYPT_CIPHER_FUNCTION_TABLE
{
    public BCRYPT_INTERFACE_VERSION Version;
    public IntPtr OpenAlgorithmProvider;
    public IntPtr GetProperty;
    public IntPtr SetProperty;
    public IntPtr CloseAlgorithmProvider;
    public IntPtr GenerateKey;
    public IntPtr Encrypt;
    public IntPtr Decrypt;
    public IntPtr ImportKey;
    public IntPtr ExportKey;
    public IntPtr DuplicateKey;
    public IntPtr DestroyKey;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BCRYPT_INTERFACE_VERSION
    Public MajorVersion As UShort
    Public MinorVersion As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BCRYPT_CIPHER_FUNCTION_TABLE
    Public Version As BCRYPT_INTERFACE_VERSION
    Public OpenAlgorithmProvider As IntPtr
    Public GetProperty As IntPtr
    Public SetProperty As IntPtr
    Public CloseAlgorithmProvider As IntPtr
    Public GenerateKey As IntPtr
    Public Encrypt As IntPtr
    Public Decrypt As IntPtr
    Public ImportKey As IntPtr
    Public ExportKey As IntPtr
    Public DuplicateKey As IntPtr
    Public DestroyKey As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class BCRYPT_INTERFACE_VERSION(ctypes.Structure):
    _fields_ = [
        ("MajorVersion", ctypes.c_ushort),
        ("MinorVersion", ctypes.c_ushort),
    ]

class BCRYPT_CIPHER_FUNCTION_TABLE(ctypes.Structure):
    _fields_ = [
        ("Version", BCRYPT_INTERFACE_VERSION),
        ("OpenAlgorithmProvider", ctypes.c_void_p),
        ("GetProperty", ctypes.c_void_p),
        ("SetProperty", ctypes.c_void_p),
        ("CloseAlgorithmProvider", ctypes.c_void_p),
        ("GenerateKey", ctypes.c_void_p),
        ("Encrypt", ctypes.c_void_p),
        ("Decrypt", ctypes.c_void_p),
        ("ImportKey", ctypes.c_void_p),
        ("ExportKey", ctypes.c_void_p),
        ("DuplicateKey", ctypes.c_void_p),
        ("DestroyKey", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct BCRYPT_INTERFACE_VERSION {
    pub MajorVersion: u16,
    pub MinorVersion: u16,
}

#[repr(C)]
pub struct BCRYPT_CIPHER_FUNCTION_TABLE {
    pub Version: BCRYPT_INTERFACE_VERSION,
    pub OpenAlgorithmProvider: *mut core::ffi::c_void,
    pub GetProperty: *mut core::ffi::c_void,
    pub SetProperty: *mut core::ffi::c_void,
    pub CloseAlgorithmProvider: *mut core::ffi::c_void,
    pub GenerateKey: *mut core::ffi::c_void,
    pub Encrypt: *mut core::ffi::c_void,
    pub Decrypt: *mut core::ffi::c_void,
    pub ImportKey: *mut core::ffi::c_void,
    pub ExportKey: *mut core::ffi::c_void,
    pub DuplicateKey: *mut core::ffi::c_void,
    pub DestroyKey: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type BCRYPT_INTERFACE_VERSION struct {
	MajorVersion uint16
	MinorVersion uint16
}

type BCRYPT_CIPHER_FUNCTION_TABLE struct {
	Version BCRYPT_INTERFACE_VERSION
	OpenAlgorithmProvider uintptr
	GetProperty uintptr
	SetProperty uintptr
	CloseAlgorithmProvider uintptr
	GenerateKey uintptr
	Encrypt uintptr
	Decrypt uintptr
	ImportKey uintptr
	ExportKey uintptr
	DuplicateKey uintptr
	DestroyKey uintptr
}
type
  BCRYPT_INTERFACE_VERSION = record
    MajorVersion: Word;
    MinorVersion: Word;
  end;

  BCRYPT_CIPHER_FUNCTION_TABLE = record
    Version: BCRYPT_INTERFACE_VERSION;
    OpenAlgorithmProvider: Pointer;
    GetProperty: Pointer;
    SetProperty: Pointer;
    CloseAlgorithmProvider: Pointer;
    GenerateKey: Pointer;
    Encrypt: Pointer;
    Decrypt: Pointer;
    ImportKey: Pointer;
    ExportKey: Pointer;
    DuplicateKey: Pointer;
    DestroyKey: Pointer;
  end;
const BCRYPT_INTERFACE_VERSION = extern struct {
    MajorVersion: u16,
    MinorVersion: u16,
};

const BCRYPT_CIPHER_FUNCTION_TABLE = extern struct {
    Version: BCRYPT_INTERFACE_VERSION,
    OpenAlgorithmProvider: ?*anyopaque,
    GetProperty: ?*anyopaque,
    SetProperty: ?*anyopaque,
    CloseAlgorithmProvider: ?*anyopaque,
    GenerateKey: ?*anyopaque,
    Encrypt: ?*anyopaque,
    Decrypt: ?*anyopaque,
    ImportKey: ?*anyopaque,
    ExportKey: ?*anyopaque,
    DuplicateKey: ?*anyopaque,
    DestroyKey: ?*anyopaque,
};
type
  BCRYPT_INTERFACE_VERSION {.bycopy.} = object
    MajorVersion: uint16
    MinorVersion: uint16

  BCRYPT_CIPHER_FUNCTION_TABLE {.bycopy.} = object
    Version: BCRYPT_INTERFACE_VERSION
    OpenAlgorithmProvider: pointer
    GetProperty: pointer
    SetProperty: pointer
    CloseAlgorithmProvider: pointer
    GenerateKey: pointer
    Encrypt: pointer
    Decrypt: pointer
    ImportKey: pointer
    ExportKey: pointer
    DuplicateKey: pointer
    DestroyKey: pointer
struct BCRYPT_INTERFACE_VERSION
{
    ushort MajorVersion;
    ushort MinorVersion;
}

struct BCRYPT_CIPHER_FUNCTION_TABLE
{
    BCRYPT_INTERFACE_VERSION Version;
    void* OpenAlgorithmProvider;
    void* GetProperty;
    void* SetProperty;
    void* CloseAlgorithmProvider;
    void* GenerateKey;
    void* Encrypt;
    void* Decrypt;
    void* ImportKey;
    void* ExportKey;
    void* DuplicateKey;
    void* DestroyKey;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; BCRYPT_CIPHER_FUNCTION_TABLE サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; Version : BCRYPT_INTERFACE_VERSION (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; OpenAlgorithmProvider : BCryptOpenAlgorithmProviderFn (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; GetProperty : BCryptGetPropertyFn (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; SetProperty : BCryptSetPropertyFn (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; CloseAlgorithmProvider : BCryptCloseAlgorithmProviderFn (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; GenerateKey : BCryptGenerateSymmetricKeyFn (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; Encrypt : BCryptEncryptFn (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Decrypt : BCryptDecryptFn (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ImportKey : BCryptImportKeyFn (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ExportKey : BCryptExportKeyFn (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; DuplicateKey : BCryptDuplicateKeyFn (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; DestroyKey : BCryptDestroyKeyFn (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; BCRYPT_CIPHER_FUNCTION_TABLE サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; Version : BCRYPT_INTERFACE_VERSION (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; OpenAlgorithmProvider : BCryptOpenAlgorithmProviderFn (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; GetProperty : BCryptGetPropertyFn (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; SetProperty : BCryptSetPropertyFn (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; CloseAlgorithmProvider : BCryptCloseAlgorithmProviderFn (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; GenerateKey : BCryptGenerateSymmetricKeyFn (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; Encrypt : BCryptEncryptFn (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; Decrypt : BCryptDecryptFn (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ImportKey : BCryptImportKeyFn (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ExportKey : BCryptExportKeyFn (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; DuplicateKey : BCryptDuplicateKeyFn (+80, 8byte)  qpoke st,80,値 / qpeek(st,80)  ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; DestroyKey : BCryptDestroyKeyFn (+88, 8byte)  qpoke st,88,値 / qpeek(st,88)  ※IronHSPのみ。3.7/3.8は lpoke st,88,下位 : lpoke st,92,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global BCRYPT_INTERFACE_VERSION
    #field short MajorVersion
    #field short MinorVersion
#endstruct

#defstruct global BCRYPT_CIPHER_FUNCTION_TABLE
    #field BCRYPT_INTERFACE_VERSION Version
    #field intptr OpenAlgorithmProvider
    #field intptr GetProperty
    #field intptr SetProperty
    #field intptr CloseAlgorithmProvider
    #field intptr GenerateKey
    #field intptr Encrypt
    #field intptr Decrypt
    #field intptr ImportKey
    #field intptr ExportKey
    #field intptr DuplicateKey
    #field intptr DestroyKey
#endstruct

stdim st, BCRYPT_CIPHER_FUNCTION_TABLE        ; NSTRUCT 変数を確保