ホーム › Security.Cryptography › CRYPT_XML_ALGORITHM_INFO

CRYPT_XML_ALGORITHM_INFO

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 72 バイト / x86: 40 バイト

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

フィールド

型

サイズ

x64

x86

説明

cbSize

DWORD

この構造体のサイズ (バイト単位)。

wszAlgorithmURI

LPWSTR

8/4

XML 署名の SignatureMethod 要素または DigestMethod 要素の属性に関連付けられた URI を格納する、NULL で終わる Unicode 文字列へのポインターです。

wszName

LPWSTR

8/4

+16

省略可能です。アルゴリズムの表示名を格納する、NULL で終わる Unicode 文字列へのポインターです。

dwGroupId

CRYPT_XML_GROUP_ID

+24

+12

アルゴリズムが属するグループの種類を指定する DWORD 値です。このメンバーには次のいずれかの値を指定できます。

値	意味
CRYPT_XML_GROUP_ID_HASH 1	ハッシュアルゴリズム
CRYPT_XML_GROUP_ID_SIGN 2	署名アルゴリズム

wszCNGAlgid

LPWSTR

8/4

+32

+16

Cryptography API: Next Generation (CNG) の関数に渡されるアルゴリズム識別子文字列を格納する、NULL で終わる Unicode 文字列へのポインターです。CNG の関数では、CALG_SHA1 のような ALG_ID データ型の定数ではなく、L"SHA1" のようなアルゴリズム識別子文字列を使用します。

注意 BCrypt* および NCrypt* の関数は Bcrypt.h と Ncrypt.h で定義されています。

wszCNGExtraAlgid

LPWSTR

8/4

+40

+20

pwszCNGAlgid メンバーの文字列とは別に CNG の関数に渡される、追加のアルゴリズム文字列を格納する、NULL で終わる Unicode 文字列へのポインターです。

注意 BCrypt* および NCrypt* の関数は Bcrypt.h と Ncrypt.h で定義されています。

dwSignFlags

DWORD

+48

+24

NCryptSignHash 関数に渡されるフラグ値を格納する DWORD 値です。

dwVerifyFlags

DWORD

+52

+28

BCryptVerifySignature 関数に渡される DWORD 値です。

pvPaddingInfo

void*

8/4

+56

+32

NCryptSignHash 関数または BCryptVerifySignature 関数に渡されるパディング情報を格納する構造体へのポインターです。このメンバーが指す構造体の実際の型は、dwGroupId メンバーの値によって決まります。

pvExtraInfo

void*

8/4

+64

+36

省略可能です。CNG の関数に渡すことができる追加情報を格納する構造体へのポインターです。

注意 BCrypt* および NCrypt* の関数は Bcrypt.h と Ncrypt.h で定義されています。

公式ドキュメント

CRYPT_XML_ALGORITHM_INFO 構造体は、アルゴリズム情報を格納します。

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

各言語での定義

#include <windows.h>

// CRYPT_XML_ALGORITHM_INFO  (x64 72 / x86 40 バイト)
typedef struct CRYPT_XML_ALGORITHM_INFO {
    DWORD cbSize;
    LPWSTR wszAlgorithmURI;
    LPWSTR wszName;
    CRYPT_XML_GROUP_ID dwGroupId;
    LPWSTR wszCNGAlgid;
    LPWSTR wszCNGExtraAlgid;
    DWORD dwSignFlags;
    DWORD dwVerifyFlags;
    void* pvPaddingInfo;
    void* pvExtraInfo;
} CRYPT_XML_ALGORITHM_INFO;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPT_XML_ALGORITHM_INFO
{
    public uint cbSize;
    public IntPtr wszAlgorithmURI;
    public IntPtr wszName;
    public uint dwGroupId;
    public IntPtr wszCNGAlgid;
    public IntPtr wszCNGExtraAlgid;
    public uint dwSignFlags;
    public uint dwVerifyFlags;
    public IntPtr pvPaddingInfo;
    public IntPtr pvExtraInfo;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPT_XML_ALGORITHM_INFO
    Public cbSize As UInteger
    Public wszAlgorithmURI As IntPtr
    Public wszName As IntPtr
    Public dwGroupId As UInteger
    Public wszCNGAlgid As IntPtr
    Public wszCNGExtraAlgid As IntPtr
    Public dwSignFlags As UInteger
    Public dwVerifyFlags As UInteger
    Public pvPaddingInfo As IntPtr
    Public pvExtraInfo As IntPtr
End Structure

import ctypes
from ctypes import wintypes

class CRYPT_XML_ALGORITHM_INFO(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("wszAlgorithmURI", ctypes.c_void_p),
        ("wszName", ctypes.c_void_p),
        ("dwGroupId", wintypes.DWORD),
        ("wszCNGAlgid", ctypes.c_void_p),
        ("wszCNGExtraAlgid", ctypes.c_void_p),
        ("dwSignFlags", wintypes.DWORD),
        ("dwVerifyFlags", wintypes.DWORD),
        ("pvPaddingInfo", ctypes.c_void_p),
        ("pvExtraInfo", ctypes.c_void_p),
    ]

#[repr(C)]
pub struct CRYPT_XML_ALGORITHM_INFO {
    pub cbSize: u32,
    pub wszAlgorithmURI: *mut core::ffi::c_void,
    pub wszName: *mut core::ffi::c_void,
    pub dwGroupId: u32,
    pub wszCNGAlgid: *mut core::ffi::c_void,
    pub wszCNGExtraAlgid: *mut core::ffi::c_void,
    pub dwSignFlags: u32,
    pub dwVerifyFlags: u32,
    pub pvPaddingInfo: *mut core::ffi::c_void,
    pub pvExtraInfo: *mut core::ffi::c_void,
}

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

type CRYPT_XML_ALGORITHM_INFO struct {
	cbSize uint32
	wszAlgorithmURI uintptr
	wszName uintptr
	dwGroupId uint32
	wszCNGAlgid uintptr
	wszCNGExtraAlgid uintptr
	dwSignFlags uint32
	dwVerifyFlags uint32
	pvPaddingInfo uintptr
	pvExtraInfo uintptr
}

type
  CRYPT_XML_ALGORITHM_INFO = record
    cbSize: DWORD;
    wszAlgorithmURI: Pointer;
    wszName: Pointer;
    dwGroupId: DWORD;
    wszCNGAlgid: Pointer;
    wszCNGExtraAlgid: Pointer;
    dwSignFlags: DWORD;
    dwVerifyFlags: DWORD;
    pvPaddingInfo: Pointer;
    pvExtraInfo: Pointer;
  end;

const CRYPT_XML_ALGORITHM_INFO = extern struct {
    cbSize: u32,
    wszAlgorithmURI: ?*anyopaque,
    wszName: ?*anyopaque,
    dwGroupId: u32,
    wszCNGAlgid: ?*anyopaque,
    wszCNGExtraAlgid: ?*anyopaque,
    dwSignFlags: u32,
    dwVerifyFlags: u32,
    pvPaddingInfo: ?*anyopaque,
    pvExtraInfo: ?*anyopaque,
};

type
  CRYPT_XML_ALGORITHM_INFO {.bycopy.} = object
    cbSize: uint32
    wszAlgorithmURI: pointer
    wszName: pointer
    dwGroupId: uint32
    wszCNGAlgid: pointer
    wszCNGExtraAlgid: pointer
    dwSignFlags: uint32
    dwVerifyFlags: uint32
    pvPaddingInfo: pointer
    pvExtraInfo: pointer

struct CRYPT_XML_ALGORITHM_INFO
{
    uint cbSize;
    void* wszAlgorithmURI;
    void* wszName;
    uint dwGroupId;
    void* wszCNGAlgid;
    void* wszCNGExtraAlgid;
    uint dwSignFlags;
    uint dwVerifyFlags;
    void* pvPaddingInfo;
    void* pvExtraInfo;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRYPT_XML_ALGORITHM_INFO サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; wszAlgorithmURI : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; wszName : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwGroupId : CRYPT_XML_GROUP_ID (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; wszCNGAlgid : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; wszCNGExtraAlgid : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwSignFlags : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwVerifyFlags : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; pvPaddingInfo : void* (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pvExtraInfo : void* (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPT_XML_ALGORITHM_INFO サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; wszAlgorithmURI : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; wszName : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; dwGroupId : CRYPT_XML_GROUP_ID (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; wszCNGAlgid : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; wszCNGExtraAlgid : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; dwSignFlags : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwVerifyFlags : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; pvPaddingInfo : void* (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pvExtraInfo : void* (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CRYPT_XML_ALGORITHM_INFO
    #field int cbSize
    #field intptr wszAlgorithmURI
    #field intptr wszName
    #field int dwGroupId
    #field intptr wszCNGAlgid
    #field intptr wszCNGExtraAlgid
    #field int dwSignFlags
    #field int dwVerifyFlags
    #field intptr pvPaddingInfo
    #field intptr pvExtraInfo
#endstruct

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

CRYPT_XML_ALGORITHM_INFO

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義