ホーム › Security.Cryptography › CRYPT_XML_TRANSFORM_INFO

CRYPT_XML_TRANSFORM_INFO

構造体

📘 Microsoft Learn (日本語) · English

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

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

フィールド

型

サイズ

x64

x86

説明

cbSize

DWORD

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

wszAlgorithm

LPWSTR

8/4

Algorithm 属性を格納する、NULL 終端の Unicode 文字列へのポインター。

cbBufferSize

DWORD

+16

データプロバイダーのバッファーのサイズ (バイト単位)。初期化時にサイズを判別できない場合は 0 を指定できます。この値は、pfnCreateTransform メンバーが指す構造体の呼び出し元が、受け取り側のバッファーに必要なサイズを判別するために使用します。

dwFlags

CRYPT_XML_TRANSFORM_FLAGS

+20

+12

変換の適用方法を制御する値を指定します。

このメンバーには、次の値のうち 1 つ以上を指定できます。

値	意味
CRYPT_XML_TRANSFORM_ON_STREAM 0x00000001	変換への入力がバイトのストリームであることを指定します。
CRYPT_XML_TRANSFORM_ON_NODESET 0x00000002	変換への入力が XML ノードセットであることを指定します。
CRYPT_XML_TRANSFORM_URI_QUERY_STRING 0x00000003	URI の比較を、QueryString を除いたコア URI に対して実行することを指定します。場合によっては、URI のアンパサンド (&) 以降の QueryString に追加情報が含まれていることがあります。コア URI のみを評価するには、このフラグを使用します。

pfnCreateTransform

PFN_CRYPT_XML_CREATE_TRANSFORM

8/4

+24

+16

変換の作成に使用される PFN_CRYPT_XML_CREATE_TRANSFORM コールバック関数へのポインター。

公式ドキュメント

CRYPT_XML_TRANSFORM_INFO 構造体は、データ変換を適用する際に使用される情報を格納します。

解説(Remarks)

XML 正規化変換の場合、cbBufferSize メンバーで指定するバッファーサイズは、すべての属性値を含む Start 要素全体を格納できる大きさでなければなりません。

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

各言語での定義

#include <windows.h>

// CRYPT_XML_TRANSFORM_INFO  (x64 32 / x86 20 バイト)
typedef struct CRYPT_XML_TRANSFORM_INFO {
    DWORD cbSize;
    LPWSTR wszAlgorithm;
    DWORD cbBufferSize;
    CRYPT_XML_TRANSFORM_FLAGS dwFlags;
    PFN_CRYPT_XML_CREATE_TRANSFORM pfnCreateTransform;
} CRYPT_XML_TRANSFORM_INFO;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPT_XML_TRANSFORM_INFO
{
    public uint cbSize;
    public IntPtr wszAlgorithm;
    public uint cbBufferSize;
    public uint dwFlags;
    public IntPtr pfnCreateTransform;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPT_XML_TRANSFORM_INFO
    Public cbSize As UInteger
    Public wszAlgorithm As IntPtr
    Public cbBufferSize As UInteger
    Public dwFlags As UInteger
    Public pfnCreateTransform As IntPtr
End Structure

import ctypes
from ctypes import wintypes

class CRYPT_XML_TRANSFORM_INFO(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("wszAlgorithm", ctypes.c_void_p),
        ("cbBufferSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("pfnCreateTransform", ctypes.c_void_p),
    ]

#[repr(C)]
pub struct CRYPT_XML_TRANSFORM_INFO {
    pub cbSize: u32,
    pub wszAlgorithm: *mut core::ffi::c_void,
    pub cbBufferSize: u32,
    pub dwFlags: u32,
    pub pfnCreateTransform: *mut core::ffi::c_void,
}

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

type CRYPT_XML_TRANSFORM_INFO struct {
	cbSize uint32
	wszAlgorithm uintptr
	cbBufferSize uint32
	dwFlags uint32
	pfnCreateTransform uintptr
}

type
  CRYPT_XML_TRANSFORM_INFO = record
    cbSize: DWORD;
    wszAlgorithm: Pointer;
    cbBufferSize: DWORD;
    dwFlags: DWORD;
    pfnCreateTransform: Pointer;
  end;

const CRYPT_XML_TRANSFORM_INFO = extern struct {
    cbSize: u32,
    wszAlgorithm: ?*anyopaque,
    cbBufferSize: u32,
    dwFlags: u32,
    pfnCreateTransform: ?*anyopaque,
};

type
  CRYPT_XML_TRANSFORM_INFO {.bycopy.} = object
    cbSize: uint32
    wszAlgorithm: pointer
    cbBufferSize: uint32
    dwFlags: uint32
    pfnCreateTransform: pointer

struct CRYPT_XML_TRANSFORM_INFO
{
    uint cbSize;
    void* wszAlgorithm;
    uint cbBufferSize;
    uint dwFlags;
    void* pfnCreateTransform;
}

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_TRANSFORM_INFO サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; wszAlgorithm : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; cbBufferSize : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwFlags : CRYPT_XML_TRANSFORM_FLAGS (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pfnCreateTransform : PFN_CRYPT_XML_CREATE_TRANSFORM (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPT_XML_TRANSFORM_INFO サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; wszAlgorithm : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; cbBufferSize : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwFlags : CRYPT_XML_TRANSFORM_FLAGS (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; pfnCreateTransform : PFN_CRYPT_XML_CREATE_TRANSFORM (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CRYPT_XML_TRANSFORM_INFO
    #field int cbSize
    #field intptr wszAlgorithm
    #field int cbBufferSize
    #field int dwFlags
    #field intptr pfnCreateTransform
#endstruct

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